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About  This  Guide 


Welcome  to  CA-Viewl 

Welcome  to  GA-View,  a  SYSOUT  archival  and  retrieval  system  that  stores 
computer  output  on  either  DASD  or  tape  and  retrieves  that  output  upon 
demand. 


Who  Should  Read  This  Guide? 


This  guide  is  designed  as  a  reference  for  system  programmers,  administrators, 
and  CA-View  end  users. 

This  guide  assumes  you  are  familiar  with  CA-View  and  IBM  computer  system 
terms  and  concepts.  You  should  also  have  a  working  knowledge  of  MVS  oidine 
facilities,  such  as  ISPF,  since  the  CA-View  panels  behave  in  a  similar  fashion. 


What’S  In  This  Guide? 

The  CA-View  System  Reference  Guide  is  organized  as  follows: 

Chapter  1 

"Introducing  CA-View"  outlines  the  documentation,  presents  an  overview  of 
CA-View,  and  provides  general  processing  information. 

Chapter  2 

"Initialization  Parameters"  explains  how  to  set  and  change  initialization 
parameters  and  expanded  retention  parameters. 

Chapter  3 

"Configuring  CA-View"  details  the  configurable  components  of  CA-View. 

Chapter  4 

"Online  Interface  Administration"  provides  information  about  the  various  online 
retrieval  systems. 

Chapters 

"Archival"  provides  information  about  the  archival  of  SYSOUT,  AFP,  and  Xerox 
reports,  and  covers  exceptional  condition  checking. 

Chapters 

"Expanded  Retention  Option"  explains  ERO  table  statements,  assigiring  SYSOUT 
IDs,  and  tape  consolidation  of  reports. 
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Product  Documentation 


Chapter  7 
Chapters 

Chapter  9 

Chapter  10 

Chapter  1 1 
Chapter  12 


Database  Utilities"  details  each  of  the  GA-View  database  utilities. 


i-iTh^S  Recovering  the  Database"  explains  how  to  back  up  and  recover 

the  database  mminuze  non-archival  time,  recover  from  media  and  integrity 
problems,, and  use  forward  recovery  data. 

"Batch  Processing"  discusses  the  SARBCH  program,  which  performs  batch 
retrieval  functions. 


"Usmg  the  Optical  Disk  Interface"  discusses  the  optical  disk  drivers,  page- 
access  to  optical  disk,  and  database  maintenance 


User  Exits"  details  the  user  exits  that  allow  you  to  customize  CA-View. 
Di^ostic  and  Error  Messages"  documents  the  messages  generated  by 


Appendix  A 


Appendix  B 


Data  Sets  and  Environmental  Considerations"  discusses  the  CA-View  database 
the  tape  archival  data  sets,  and  the  other  data  sets  used  by  CA-View, 

"Troubleshooting  and  Technical  Support"  explains  how  to  diagnose  software 
problems  and  contact  Computer  Associates  Technical  Support. 


Product  Documentation 

The  following  publications  are  supplied  with  CA-View: 

■  CA-View  Online  User's  Guide 

■  CA-View  System  Reference  Guide 

■  CA-View  Installation  Guide 


Contacting  Technicai  Support 

Refer  to  Appendix  B;  "Troubleshooting  and  Technical  Support,"  for  information 
about  contactmg  Computer  Associates  Technical  Support. 
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Conventions  Used  in  This  Guide 


Commands  and 
Parameters 

Variables 


Commands 


PF  Keys 


This  section  explains  the  conventions  used  to  present  information  in  this  guide. 
We  recommend  that  you  take  the  time  to  familiarize  yourself  with  these 
conventions. 

Commands  and  parameters  are  shown  in  this  font.  You  enter  these  examples 
in  CA-View  exactly  as  shown. 

Italic  text  shown  with  a  command  indicates  a  user-defined  variable.  For 
example,  in  place  of  the  variable  printer-id.data,  you.  might  enter  VPS.JESDS. 

Commands  you  can  issue  are  presented  in  uppercase  letters.  For  example: 

■  HELP 

■  SELECT 

The  word  ENTER  in  uppercase  represents  the  following  keys  on  your  keyboard: 

■  ENTER,  Enter,  or  enter 

■  RETURN,  Retirm,  or  return 

■ 

Programmable  function  keys,  or  PF  keys,  are  represented  by  the  uppercase 
letters  PF,  followed  by  one  or  two  digits,  as  shown  in  the  examples  below: 

■  PFl 

■  PF12 


Note:  On  most  keyboards,  PF  keys  are  located  either  at  the  top  or  to  the  right 
side  of  the  main  part  of  the  keyboard.  PF  keys  are  usually  marked  PF  or  simply 
F  followed  by  a  digit  (for  example,  PF  1  or  FI). 


CA"View:  Learning  About  Past  and  Present  Releases 

The  following  sections  provide  you  with  a  "history"  of  CA-View,  starting  with 
the  current  release  and  working  backward  to  SAR  6.5.  Each  section  includes  a  list 
and  an  overview  of  the  new  features  and  enhancements  that  appeared  when  that 
iteration  of  the  product  was  released.  Information  is  presented  for: 

■  CA-View  2.0 

■  CA-View  1.7 

■  Prevail/XP — ^View  1.6.7 

■  SAR  6.5 


About  This  Guide  ATG-3 


CA-View  2.0  -  New  Features  and  Enhancements 


CA-View  2.0  -  New  Features  and  Enhancements 

The  new  features  in  GA-View  Release  2.0  include:  the  CA  LMP  authorization 
system,  year  2000  support,  browse  ANNOTATE,  BOOKMARK,  and  GOTO 
commands,  private  logical  views,  and  global  views  across  many  reports. 

Enhancements  have  been  made  to:  expanded  access  server  for  tape  and  robotics 
functionality,  the  SARDBASE  restore,  logical  views,  and  indexing. 

Overview  of  CA-View  2.0  Modifications 

This  section  presents  an  overview  of  each  of  the  new  features,  commands,  and 
enhancements  in  CA-View  Release  2.0. 


New  Parameters  for  Expanded  Access  Servers  for  Tape  and  Robotics 

The  parameters  added  to  CA-View  in  this  release  fimctionally  replace  the 
EASTNAME  initialization  parameter,  as  follows: 

■  EASTNAMl  to  EASTNAM3 

The  EASTNAMl  to  EASTNAME3  initialization  parameters  allow  the 
reference  of  up  to  three  Expanded  Access  Servers  for  Tape  and  Robotics 
systems  when  accessing  report  data  that  resides  on  tape  or  tape  emulation 
optical  disks. 

These  new  parameters  additionally  allow  the  specification  of  unit  names 
referenced  in  the  storage  group  (STORGRPz)  parameters  that  are  to  be 
accessed  specifically  by  that  Expanded  Access  Server. 

■  EROOPT 

This  new  parameter  allows  you  to  specify  whether  the  Expanded  Retention 
Option  is  being  used  for  a  new  or  existing  database.  You  can  indicate  YES  to 
retain  Expanded  Retention  Initialization  parameters,  or  NO  to  delete 
references  to  aU  Expanded  Retention  Initialization  parameters. 

■  EXPDT 

This  parameter  was  enhanced  to  allow  a  second  form  of  tape  expiration  date, 
yyyyMd  (in  addition  to  to  conform  to  IBM's  expiration  date 

specifications. 

Use  of  the  new  form' of  expiration  date  will  require  a  supportable  level  of  the 
IBM  operating  system  and  a  tape  management  product,  if  applicable. 
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CALMP 


This  is  the  first  release  of  CA-View  that  requires  the  use  of  the  CA  LMP 
authorization  code  system.  GA  LMP  replaces  the  PRODCODl  and  PRODGOE)2 
initialization  parameters,  which  have  been  removed. 

CA90s  must  be  installed  before  you  can  use  CA-View. 


Year  2000  Support 

Year  2000  support  has  been  added  to  the  new  release  of  GA-View.  The  product 
uses  a  date  window  to  conform  to  year  2000  compliance.  Years  00  to  69  represent 
the  years  2000  to  2069,  and  years  70  to  99  represent  years  1970  to  1999.  Year  2000 
is  recognized  as  a  leap  year.  Where  applicable,  years  00  through  69  will  be  sorted 
sequentially  after  years  70  to  99. 

Browse  ANNOTATE  and  BOOKMARK  Commands 

The  ANNOTATE  and  BOOKMARK  browse  commands,  abbreviated  A  and  B, 
can  be  used  to  create  or  attach  comments  or  labels  to  the  report  data.  Annotations 
contain  text;  bookmarks  contain  no  text,  and  are  used  to  mark  report  sections  for 
easy  access. 

The  annotations  and  bookmarks  can  be  attached  to  any  line  of  a  report.  The 
ANNOTATE  command  will^  display  previously-attached  annotation  text  and 
allow  input  of  new  annotation  text.  The  newly-added  annotation  text  can  be 
marked  as  private  (viewable  by  end  users  only)  or  public  (viewable  by  all  users). 

For  information  about  using  annotations  and  bookmarks,  refer  to  Chapter  5, 
"Browsing  Output,"  in  the  CA-View  Online  User's  Guide. 


Browse  GOTO  Command 


This  command  allows  you  to  display  the  Annotation/Bookmark  Selection  list  in 
browse  mode,  where  you  can  browse  the  annotations  and  bookmarks  that  have 
been  created  for  a  report. 
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SARDBASE  Restore 


The  SARDBASE  RESTORE  process  has  been  enhanced  for  performance  and  end^ 
user  friendliness. 


When  a  SARDBASE  RESTORE  is  performed  without  specifying  the  "from" 
(damaged)  CA-View  database,  restored  reports  will  no  longer  show  PERM  or 
DISK  online  status,  but  rather  a  PTAP  or  TAPE  status.  These  reports  will  be 
immediately  accessible  by  the  Expanded  Access  Server  for  Tape  and  Robotics. 
SARRSP  can  still  be  used  to  restore  the  reports  that  were  m  PERM  or  DISK  status 
to  disk. 


Private  Logical  Views 


This  new  feature  allows  you  to  create  a  private  logical  view  of  a  report  for  your 
own  use.  Other  users  cannot  access  your  private  view. 

You  can  create  a  private  view  if' you  are  defined  to  the  system  as  a  non-restricted 
user;  that  is,  you  have  access  to  ^e  native  (imsecured)  view  of  a  report. 

For  more  information  about  using  private  views,  refer  to  Chapter  5,  "Browsing 
Output,"  in  the  CA-View  Online  User's  Guide. 

increased  Number  of  Logical  Views 

The  limit  of  logical  views  of  a  report  has  been  increased  from  9  to  255.  This  limit 
applies  to  the  current  public  views,  new  private  logical  views,  and  new  global 
logical  views.  The  View  Selection  panel  has  been  changed  to  a  scrollable  selection 
list. 


Indexing 


Indexing  for  private  and  global  views  is  done  as  in  the  logical  view  definition  for 
pubKc  views.  For  private  views,  the  index  defined  must  match  the  index 
definition  in  a  public  or  global  view. 

To  avoid  overloading  the  system  with  individual  user's  indexes,  private  logical 
views  can  only  be  used  to  create  new  page  indexes  if  their  index  defmitions 
match  an  existing  public  or  global  view  index  definition. 
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Global  Views  Across  Many  Reports 


This  new  feature  allows  you  to  define  global  logical  views  across  many  reports. 

When  you  define  a  viev/,  you  can  specify  which  reports  can  be  formatted  with 
that  view  definition  by  specifying  a  generic  Report  ID  in  the  definition  (for 
example,  PAY*). 

Only  users  with  master  authority  specified  by  the  DEF  USER  statement  can  create 
global  logical  views. 

For  more  information  about  using  global  views,  refer  to  Qhapter  5,  "Browsing 
Output,"  in  the  CA-View  Online  User's  Guide. 


Panels  Modified  for  Logical  View  Enhancements 

■  The  Logical  View  Selection  panel  has  been  changed  from  a  static  display 
containing  a  maximum  of  nine  logical  views  to  a  standard  scrollable  selection 
list. 

■  The  Logical  View  Definition  panel  has  a  new  field  which  permits  the  user  to 
identify  the  view  as  private  or  public.  Defining  a  logical  view  can  now  be 
done  via  a  new  command  line  command,  DEF  VIEW  (rather  than  only 
through  the  browse  function).  Report  ID  will  be  accepted  to  accommodate 
the  concept  of  global  views  (one  view  definition  applies  to  many  reports). 

■  The  SYSOUT  (or  Report)  Selection  List  has  been  modified.  The  Selection 
column  has  been  changed  to  accommodate  the  longer  view  numbers  that  can 
be  entered  when  the  user  wants  to  go  directly  into  a  desired  view  via  the 
Vnnn  selection  code. 


CA-View  1 .7  -  New  Features  and  Enhancements 

This  section  presents  an  overview  of  the  features,  commands,  and  enhancements 
new  in  CA-View  Release  1.7. 


Overview  of  CA-View  1 .7  Modifications 

The  new  features  in  CA-View  1.7  included:  SMP/E  installation;  ACIF  and  Xerox 
cross-report  indexing;  Xerox  Metacode  and  LCDS  PC  viewing;  a  new  SAREAS 
parameter;  new  SARINTT  parameters;  and  new  user  exits.  Enhancements  have 
been  made  to  index  selection,  SARDBASE  parameters,  and  SARTDR  TADD. 
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SMP/E  InstCillation 


The  System  Modification  Program/Extended  (SMP/E)  is  used  to  install!  tailor, 
and  maintain  CA-View  1.7.  SMP/E  provides  the  ability  to  control  these  activities 
in  a  consistent  manner. 


ACIP  and  XEROX  Gross-Report  Indexing 


Cross-report  indexing  can  now  include  ACIF  and  DVS  XEROX  reports. 


Xerox  Metocode  and  LCDS  PC  Viewing 

CA-View  works  with  a  mainframe  component  called  the  Document  Viewing 
Services  (DVS)  Printer  Emulator,  available  from  Document  Sciences  (a  Xerox 
subsidiary). 


The  Printer  Emulator  provides  Metacode  and  LCDS  conversion  and  indexing. 
GA-View  is  integrated  with  the  Printer  Emulator  in  a  functional  subsystem  which 
archives  the  Xerox  documents,  their  indices,  and  their  resources  into  the 
CA-View  database,  where  diey  are  available  for  viewing  on  the  PC  through 
CA-View  Workstation  and  Document  Sciences'  CompuView  Navigator. 


New  SAREAS  Parm  MOUNT=DEFER/REPLY 

MOUNT=DEFER  (the  default)  means  that  the  tape  mounts  occur  during  an 
OPEN;  the  operator  has  no  opportunity  to  reply  to  the  mount  request,  but 
mounts  can  occur  in  parallel. 

The  MOUNT=REPLY  enhancement  allows  the  operator  to  reply  to  the  tape 
mount  request,  which  occurs  during  dynamic  allocation;  all  mounts  are 
serialized. 


New  SARINIT  Parameters 


■  EASTDPLX=YES/NO 

The  default  is  EASTDPLX=NO;  which  means  that  SAREAS  will  access  only 
the  primary  volume.  EASTDPLX=YES  allows  SAREAS  to  access  a  duplex 
volume  in  the  event  that  the  primary  volume  is  not  cataloged. 
EASTDPLX=YES  would  normally  be  used  in  a  disaster  recovery  situation 
where  the  primary  volumes  no  longer  exist  or  are  inaccessible. 
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■  EASTMAXW=Mn 

The  default  is  '00'  minutes,  indicating  no  time-outs  are  to  occur  for  online 
requests  to  the  SAREAS  tape  server.  A  value  of  1  to  99  causes  CA-View  to 
time-out  a  request  to  SAREAS  after  'nn'  minutes,  thus  freeing  the  user  for 
other  work. 

■  UNITSPEC=tmitl,iinit2 

This  parameter  was  created  mainly  for  customers  using  tape-emulation 
optical;  it  allows  the  administrator  to  cause  CA-View  to  use  the  given  esoteric 
unit  name  in  all  allocations.  It  prevents  confusion  for  when  devices  are 
defined  as  the  same  type,  but  their  media  are  actually  different  (cartridges 
and  optical  platters,  for  example).  It  is  also  useful  for  MVS  images  with 
physically  separate  groups  of  identical  devices. 

■  STORGRXO-9 

These  extensions  of  STORGRP  allow  for  the  specification  of  a  duplex  Volser 
range,  and  a  maximum  number  of  blocks  to  be  written  to  a  volume  for  that 
storage  group. 

■  NGENI 

Created  for  retaining  the  master  index  separately  from  NGENT,  all  storage 
group  O's  tapes  within  NGENI  are  kept.  All  other  storage  groups'  tapes  are 
kept  only  if  there  are  reports  on  them. 


New  User  Exits 


The  SARACFUX,  SARDVSUX,  SAREASUX,  and  SARTPOUX  user  exits  have 
been  added  to  CA-View  Release  1.7  to  provide  the  following  functionality: 

■  SARACFUX 

This  exit  allows  SARSTCUX-like  processing  for  ACIF  reports  archived 
through  SARFSS. 

■  SARDVSUX 

This  exit  allows  SARSTCUX-like  processing  for  XEROX  reports. 

■  SAREASUX 

This  exit  provides  for  a  performance  improvement  for  tape-emrilationi  optical 
using  SAREAS. 

■  SARTPOUX 

This  exit  provides  for  EOV  processing  when  a  Volser  range  is  used,  and  is 
mainly  for  tape-emulation  optical. 
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Index  Selection  Enhancement 

The  main  panel  now  accepts  an  asterisk  (*)  as  a  trailing  character  for  an  index 
value,  which  provides  some  wildcard  capability.  A  new  SELECT  BY  option  (IL) 
will  position  the  index  selection  list  to  the  nearest  matching  value  if  no  exact 
match  is  made. 


Performance  Improvements  in  SARDBASE 

The  stand-alone  SARDBASE  REORG,  used  to  rebuild  the  master  index,  can  now 
nm  in  as  little  as  15  percent  of  its  pre-CA-View  1.7  execution  time.  SARDBASE 
COPY  and  SARDBASE  LOAD  have  also  had  some  performance  improvements. 


SARTDR  TADD  Builds  Alternate  Index  Entries 

There  is  no  longer  a  need  to  nm  SARDBASE  VERIFY  after  SARTDR  TADD. 
SARTDR  TADD  now  automatically  updates  the  alternate  index  so  that  date 
selection  can  be  performed  immediately. 


Prevail/XP— View  1 .6.7  -  New  Features  and  Enhancements 

This  section  presents  an  overview  of  the  features,  commands,  and  enhancements 
new  in  Prevail/XP— -View  Release  1.6.7. 


Overview  of  Prevail/XP— View  1 .6.7  Modifications 

The  new  features  in  Prevail/XP — View  1.6.7  included:  cross-report  indexing; 
multi-level  page  indexing;  use  of  expanded  access  server  for  tape  and  robotics; 
3480  block  ID  tape  processing;  compressed  format  tape  backup;  tape  storage 
groups;  AFP  report  viewing  and  printing;  cross-memory  drivers  for  ISPF,  TSO, 
and  CA-Roscoe;  an  interface  to  GSS  REXX;  download  of  AFP  resources  and  files 
to  the  PC;  DECS  support;  and  new  initialization  and  ERO  parameters. 

Enhancements  were  made  to:  the  backup  cycle,  optical  migration,  online  viewing 
and  retrieval,  ERO,  logical  viewing,  data  integrity,  language  support,  page 
indexing,  and  printing.  Some  initialization  parameters  were  enhanced,  and  others 
were  incorporated  into  other  parameters. 
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Cross-Report  Indexing 


You  can  now  assign  names  to  page  indexes,  and  apply  the  name  across  multiple 
reports.  For  example,  you  can  define: 

■  A  page  index  called  EMPLNAME  for  report  PAYROLL 

■  A  page  index  called  EMPLNAME  for  report  QUARTER  (separate  index 
location  if  necessary) 

Online  retrieval  now  gives  you  the  ability  to  specify  page  index  names,  and/or 
page  index  values  found  m  reports,  in  addition  to  SYSOUT  ID.  From  the  VIEW 
primary  panel,  some  possible  selection  criteria  are: 

■  Select  all  reports  with  the  SYSOUT  ID  PAYROLL 

■  Select  all  reports  with  the  SYSOUT  ID  PAYROLL  and  page  index 
EMPLNAME 

■  Select  all  reports  (any  SYSOUT  ID)  with  the  value  "BILL  JONES"  foimd  for 
the  page  index  EMPLNAME 

You  can  lirrut  the  number  of  reports  linked  to  a  page  index  in  two  ways,  as 
follows: 

■  The  primary  disk  database  is  searched  for  online  retrieval,  so  the  page  index 
must  be  on  the  primary  disk  database  to  be  considered  for  display  in  a 
selection  list.  Page  indexes  can  now  reside  on  disk  even  after  liieir  reports 
have  expired.  Separate  retention  can  be  assigned  with  the  new  IRETPD  ERO 
table  parameter. 

■  As  part  of  the  logical  view  specification,  you  can  specify  whether  a  logical 
view  (and  its  page  indexes)  will  participate  in  cross-report  indexing.  This 
allows  you  to  limit  searching  as  a  VIEW  database  gets  larger. 


Expanded  Access  Server  for  Tape  and  Robotics 

You  can  now  view  reports  directly  from  tape,  without  loading  back  to  disk.  This 
means  that  you  will  use  less  DASD  space  for  temporarily  loaded  reports  and 
require  fewer  tape  moimts  for  tapes  being  accessed  by  more  than  one  user. 

The  Expanded  Access  &rver  for  Tape/Robotics  has  many  parameters  that  you 
can  customize,  including: 

■  Total  number  of  tape  drives  that  may  be  accessed  at  one  time  (none  are 
dedicated  exclusively  to  the  server) 

■  Number  of  buffers  to  allocate  for  reading  data  from  tape  into  memory,  and 
number  of  blocks  to  read  ahead 

■  Number  of  minutes  a  tape  is  idle  before  its  drive  is  automatically  freed 
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You  can  also  designate  particular  reports  to  not  be  accessible  by  the  Expanded 
Access  Server,  with  the  new  VIEW  TAPE  ERO  table  parameter. 


Multi-Level  Page  Indexing 

You  can  now  sub-index  a  page  index.  For  example;  a  primary  index might  be 
division  number,  with  a  sub-index  to  that  region,  and  a  sub-index  to  that  account 
name. 

A  properly  indexed  report  can  reduce  system  resource  demands.  You  can  specify 
that  a  report  is  to  reside  on  tape  or  optical,  but  its  page  index  stays  omprimary 
disk.  For  example,  to  verify  that  a  particular  accoimt  number  is  in  the  system,  you 
can  obtain  this  infonnation  from  the  page  index  without  having  to  access  the 
report  itself.  Up  to  eight  levels  of  page  indexing  can  be  created. 


3480  Block  ID  Tape  Processing 

You  can  now  create  backup  tapes  using  3480  blbck  ID  tape.  3480  processing 
improves  performance  for  allitape  processes,  such  as: 

■  LOAD  from  tape  to  disk 

■  RESTORE  from  tape  to  disk 

■  PRINT  from  tape 

■  Consolidate  backup  tapes  with  SARPAC 


Backup  Tapes:  Compressed  Format  Option 

When  VIEW  archives  to  primary  disk,  it  compresses  the  data.  You  now  have  the 
option  of  creating  backup  tapes  in  compressed  format,  in  addition  to  regular, 
non-compressed  format.  Also,  a  new  improved  compression  algorithm  has  been 
implemented. 


Backup  Tapes:  Storage  Groups 

You  can  now  specify  up  to  mine  separate  storage  groups  for  tape,  in  addition  to  a 
default  group.  Tape  storage  groups  allow  you  to: 

■  Separate  reports  into  groups  by  viewing  frequency 

This  feature  can  be  used  to  maximize  performance  of  the  Expanded  Access 
Server,  which  allows  you  to  view  from  tape  without  loading  to  disk. 

■  Separate  reports  into  groups  by  their  retention  requirements 
This  feature  reduces  the  need  for  tape  consolidation. 
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Backup  Cycle  Enhanced 

The  VIEW  backup  cycle  has  been  changed  from  four  phases  to  two,  which  results 
in  an  improvement  in  overall  performance. 


Optical  Migration  Enhanced 


Optical  migration  has  been  enhanced  to  provide  more  flexibility:  there  is  now  a 
separate  optical  migration  subtask  of  the  VIEW  started  task.  Now  you  can: 

■  Have  VIEW  migrate  to  optical  at  predefined  intervals  (up  to  four) 

■  Delete  the  tape  copy  when  the  report  goes  to  optical 

■  Only  allow  migration  by  the  administrator  bringing  up  the  subtask  (allow  no 
automatic  migration) 

■  Allow  migration  via  a  batch  job 

■  Have  the  backup  cycle  perform  all  optical  migration  (SAR  6.5  and  previous 
releases  work  this  way) 


More  Reporting  on  Tape  Backup  and  Optical  Migration 

Two  new  reports  can  be  generated,  as  follows: 

■  SARBKLST 

The  started  task  produces  this  informational  report  when  it  completes  a 
backup  cycle.  This  report  is  created  by  specifying  a  SARBKLST  DD  statement 
in  the  started  task  JCL.  In  addition  to  listing  reports  written  to  tape, 
SARBKLST  now  lists  aU  reports  that  were  deleted,  and  any  tapes  that  were 
uncataloged. 

■  SARD2LST 

This  report  only  provides  information  on  optical  migration.  This  report  is 
created  by  adding  a  SARD2LST  DD  statement  in  the  VIEW  started  task  JCL. 


AFP  Report  Viewing/Printing 

AFP  reports  can  now  be  viewed  on  any  3270  terminal  (text  only)  and  on  any 
GDDM  terminal  (BrowseMaster  composed  report). 

BrowseMaster  composed  versions  of  AFP  reports  can  also  be  printed  from 
GDDM  terminals. 
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Online  Retrieval:  New  Commands 

The  following  new  selection  list  commands  have  been  added: 

H  DI 

Deletes  the  space  on  primary  disk  for  the  page  index  of  a  report 

Note  that  if  a  report's  page  indexes  are  not  on  primary  disk,  that  report  does 
not  participate  in  cross  report  indexing. 

■  hi 

Loads  the  page  indexes  for  the  report  from  either  tape  or  optical  to  disk 

Note  that  a  report's  page  indexes  must  be  on  primary  disk  for  it  to  participate 
in  cross-  report  indexing. 

■  LT 

Loads  the  report,  and  aU  of  its  page  indexes,  from  tape  only  to  disk;  this 
command  can  be  used  to  bypass  LOADing  from  optical  disk 

■  LX 

Loads  the  page  indexes  for  the  report  from  tape  only  to  disk;  this  command 
can  be  used  to  bypass  LOADing  from  optical  disk 


CrosS'Memory  Drivers  for  ISPF,  TSO,  and  CA-Roscoe 

New  interfaces  have  been  created  that  allow  you  to  access  TSO,  ISPF,  or 
CA-Roscoe  via  cross-memory  services;  this  provides  the  following  advantages: 

■  The  operator  interface  to  the  cross-memory  started  task  allows  you  to  cancel 
users,  specify  a  TIMEOUT  interval,  etc. 

■  No  authorization  is  necessary  from  TSO,  ISPF,  or  CA-Roscoe  (cross-memory 
provides  the  authorization). 

■  Multiple  online  interfaces  can  run  concurrently. 

■  Multiple  versions  of  VIEW  can  rrm  simultaneously  making  migration  easier. 


Asynchronous  SARTDR:  Reload  to  Disk 


The  SARTDR  utihty  no  longer  requires  exclusive  access  to  the  database.  It  can 
run  while  other  database  activities,  such  as  archive  or  backup,  are  occurring. 
SARTDR  is  used  to  load  reports  from  tape  to  disk. 
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Color  and  Highlighting 


The  VIEW  online  panel  system  now  supports  the  color  and  highlight  attributes 
bhnk  and  reverse  video. 


Filters:  Online  Viewing  Enhanced 

You  can  define  filters,  and  view  online  reports  through  those  filters.  Filters  allow 
you  to  assign  color  and  highlighting  to  areas  of  a  report  based  on: 

■  Boolean  logic  (AND,  QR,  NOT) 

■  Multiple  comparisons 

■  Nested  filter  rules 

As  an  example,  you  could  have  a  filter  that  instructs  VIEW  to: 

■  Highlight  every  third  line  of  the  report  (to  improve  online  readability) 

■  Color  all  accoimts  over  60  days  YELLOW 

■  Color  all  accoxmts  over  90  days  RED 

■  Apply  reverse  video  to  accounts  that  are  over  80  days,  but  under  90  days 

Filter  results  can  be  printed,  and  filters  can  be  either  saved  in  the  database,  or 
defined  "on  the  fly"  for  a  single  browsing  session. 


New  Retention  (ERO)  Flexibility 

Enhancements  to  ERO  allow  you  to: 

■  Establish  the  ERO  table  as  die  single  point  of  retention  control,  so  that  all 
reports  are  deleted  when  they  expire  from  ERO,  instead  of  going  to  NGEND 
or  NGENT  control  (FRET AIN  initialization  parameter) 

■  Delete  a  report  from  the  DASD  database  if  has  not  been  browsed  for  nn  days 
(LRETPD  ERO  table  parameter) 

■  Make  the  ERO  table  retroactive — that  is,  request  that  ERO  consider  every 
archived  SYSOUT  for  expanded  retention,  in  addition  to  those  archived  since 
the  last  backup  (EROPRO  initialization  parameter) 

■  Set  separate  retention  periods  for  a  report  and  its  page  index  or  indexes 
(IRETPD  ERO  table  parameter) 

This  is  particularly  useful  with  the  new  cross-report  indexing  feature, 
because  an  index  must  reside  on  DASD  to  participate  in  cross-indexing. 

■  Delete  the  tape  copy  of  a  report  when  the  report  is  migrated  to  optical  disk 
(DSK2NOTP  ERO  table  parameter) 
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Logical  Viewing:  Color 


Logical  viewing  now  supports  color  assignments  to  colvunns  and  headings. 


Data  Integrity 

■  Tape  Scratching 

The  new  SARTCHK  utility  ensures  that  you  do  not  allow  any  active  VIEW 
tapes  to  be  scratched  (uncataloged)  by  your  tape  management  system,  and 
then  overwritten.  SARTCHK  creates  a  list  of  any  active  VIEW  tapes  that  have 
been  tmcataloged. 

■  Lost  or  Damaged  Tapes 

The  SARTSLST  utility  can  be  nm  against  the  disk  database  to  see  what 
reports  were  on  a  tape,  if  a  backup  tape  is  lost,  or  damaged  and  imreadable. 
You  can  code  a  DD  statement  to  have  VIEW  automatically  backup  those 
reports  again,  or  delete  themi 


GSS;  REXX  Interface 


You  can  now  code  REXX  routines  to  cause  other  GSS  (Global  Subsystem) 
products  to  invoke  the  VIEW  batch  program  SARBCH;  you  can  use  SARBCH  to 
perform  several  administrative  fimctions,  such  as: 

■  Add,  delete,  or  modify  user  definitions 

■  Produce  a  listing  ofusers  or  reports 

■  Print  reports 

For  example,  you  can  have  a  report  printed  whenever  a  particular  job 
completes  successfully. 


Unattended  Download 


You  can  now  request  imattended  download  of  files  from  VIEW  to  an  NJE  node 
on  the  LAN  that  is  serving  PCs  running  VIEW  Workstation.  CA-Connect  is 
required. 
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AFP  -  Download  Resources  Separately 

AFP  resources  can  now  be  downloaded  from  the  mainframe  to  VIEW 
Workstations  independently  from  the  reports  that  use  them.  Thus,  all  necessary 
resources  can  be  downloaded  atone  time,  and  each  time  a  VIEW  Workstation 
user  views  an  AFP  report,  the  resource  will  already  have  been  downloaded  to  the 
PC. 


Language  Support  Enhanced 

Support  of  translation  tables  for  non-display  or  non-printing  characters  is  now 
more  flexible.  With  die  CODEPAGE  initialization  parameter,  you  can  point  to 
any  translation  table;  VIEW  is  supplied  with  tables  for  English  and  Kanji. 


Page  Indexing  Enhanced 

You  can  now  index  a  report  that  is  already  archived  to  the  VIEW  database.  For 
example,  this  allows  you  to  change  the  page  index  criteria  on  an  already  archived 
report,  and  view  the  old  report  with  the  new  index  criteria. 


More  Granularity  in  Backups 

You  can  use  the  SARBKTUX  user  exit  to  indicate  that  certain  reports  are  not  to  be 
backed  up  to  tape.  Possible  uses  are: 

■  If  a  report  was  rerun,  and  its  condition  code  was  greater  than  16,  do  not  back 
it  up. 

■  Do  not  back  up  a  particular  job  class  (for  example,  dumps,  etc.). 

■  Do  not  back  up  CICS  started  task  output. 


Print  While  Browsing 


In  addition  to  printing  from  VIEW'S  report  selection  lists,  you  can  now  print  from 
the  browse  panel,  while  looking  at  a  report.  Both  online  (PRT)  and  batch  (JPRT) 
printing  are  supported. 


DBCS  Support 


All  VIEW  online  interfaces  (TSO,  IMS,  etc.)  except  that  VM  now  supports  the 
display  of  double-byte  character  set  characters. 
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New  Ihitidlizatibn  Parameters  and  ERO  Parameters 

■  ACIFRES 

Specifies  whether  VIEW  should  reprint  AFP  reports  with  embedded 
resources 

This  allows  VIEW  to  manage  the  resources  associated  with  a  report.  Even  if  a 
resource  on  your  system  has  been  updated  since  the  report  was  archived, 
VIEW  will  use  the  appropriate  older  resource  at  reprint  time. 

■  BCHMAXRC 

Specifies  the  maximum  return  code  which  the  SARBCH  program  will  issue 

■  CODEPAGE 

Specifies  which  translation  table  (also  called  a  codepage)  VIEW  is  to  use 

The  table  is  used  to  map  non-display  characters,  or  characters  needed  for  a 
particular  language. 

■  DIRALLOC 

Specifies  the  number  of  blocks  allocated  for  Prevail/XP— Deliver  (formerly 
Express  Delivery)  direct-to-VIEW  archival 

■  EASTNAME 

Specifies  the  subsystem  name  of  the  Expanded  Access  Server  for  Tape  and 
Robotics 

■  EROPRO 

AUbws  you  to  make  the  ERO  table  retroactive — that  is,  to  request  that  ERG 
consider  every  archived  SYSOUT  for  expanded  retention 

With  SAR  6.5  and  previous  releases,  only  the  SYSOUTs  archived  since  the 
last  backup  were  considered  for  expanded  retention; 

■  EXPOPRV 

Specifies  whether  reprints  requested  m  Express  Operator  (EXPO)  mode  will 
go  to  the  user  requesting  the  reprint,  or  to  the  entire  distribution  list  for  the 
report 

■  JES3ID 

Specifies  an  alternate  subsystem  ID  for  JES3 

■  LGNRETRY 

Specifies  the  number  of  logon  failures  permitted  before  a  user  is  forced  off 
line 


■  NEWPASS 

Specifies  whether  a  new  passwordmust  be  entered  twice  to  verify  its 
accuracy 
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■  PRTASA 


Specifies  whether  VIEW  reprints  should  be  in  ASA  or  machine  control 
characters 


■  ROUTBKP 

Specifies  a  route  code  for  the  infonnational  VIEW  backup  messages, 
SARBKT61  through  SARBKT63 

■  SELPNLS 

Specifies  the  number  of  selection  panels  to  be  used  in  the  left/right  scrolling 
report  selection  lists 

■  TAPEGPT 

Specifies  options  for  tape  processing,  including  use  of  3420  or  3480/3490 
block  ID  processing  and  use  of  hardware  and  software  compaction 

■  TP054 

Specifies  whether  message  SARTP054  (tape  requires  file  protect  ring)  is  to  be 
displayed  for  the  remounting  of  archival  tapes 


New  ERO  Initialization  Parameters 

■  DSK2INTV 

Specifies  the  intervals  during  which  the  optical  migration  subtask  will 
operate 

This  parameter  works  in  conjimction  with  the  DSK2MIGD  and  DSIC2TIME 
parameters  to  schedule  automatic  optical  migration. 

■  DSK2MIGD 

Specifies  what  optical  migration  will  be  allowed  each  day  of  the  week 

The  four  options  are  A  (automatic),  M  (manually  by  the  administrator),  B  (by 
the  backup  cycle),  and  N  (no  migration  to  optical). 

■  DSK2TIME 

Specifies  the  time  intervals  during  which  optical  migration  will  automatically 
occur — ^up  to  four  ranges  can  be  specified 

■  PRETAIN 

Specifies  that  a  report  is  to  be  deleted  when  it  expires  from  ERO  (do  not  let  it 
default  to  NGEND  or  NGENT  global  control) 
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Modified  Initialization  Parameters 

FlNDLIM.=value,maxvalue 

FESIDLIM  limits  the  number  of  records  searched  before  VIEW  requires  the  user 
to  re-invoke  the  online  FIND  command. 

This  parameter  is  a  default  for  the  LIMIT  online  command,  and  may  be 
overridden  by  that  command.  This  new  form  of  the  FINDLIM  parameter  sets  the 
maximum  override  value  to  maxvalue.  For  example,  a  system  can  have  a  default 
FINDLIM  of  1,000  records,  and  allow  users  to  override  tiiis,  but  not  allow  them  to 
exceed  a  FINDLIM  of  3,000. 


Removed  initialization  Parameters 

■  FINDMAX 

This  parameter  was  available  via  PTF;it  set  a  maximum  value  for  the 
FINDLIM  override  via  the  online  LIMIT  command. 

FINDMAX  has  been  incorporated  into  the  FINDLIM  parameter. 

■  MAXGENT 

This  parameter  has  been  incorporated  into  the  new  STORGRPO  parameter 
and  the  STORGRPl  through  STORGRP9  ERO  parameters. 

■  TAPEIDX 

This  parameter  has  been  incorporated  into  the  new  STORGRPO  parameter 
and  the  STORGRPl  through  STORGRP9  ERO  parameters. 

■  TCOMPACT 

This  parameter  has  been  incorporated  into  the  new  TAPEOPT  parameter  as 
the  subparameter  HARD  I NOHARD. 

■  TVSERl  and  TVSER2 

These  parameters  have  been  incorporated  into  the  new  STORGPPO 
parameter  and  the  STORGRPl  through  STORGRF9  ERO  parameters. 

■  UNITT 

This  parameter  has  been  incorporated  into  the  new  STORGRPO  parameter 
and  the  STORGRPl  through  STORGRP9  ERO  parameters. 
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SAR  6.5  -  New  Features  and  Enhancements 


This  section  presents  an  overview  of  the  features,  commands,  and  enhancements 
new  in  SAR  Release  6.5. 


Overview  of  SAR  6.5  Modifications 

The  new  features  in  SAR  6.5  include:  archival  of  AFP  reports;  archival  to  IBM 
DASD  emulation  optical  devices;  SMS  support  for  database  allbcation;  user- 
defined  exceptional  condition  checking;  \^/XA  support;  the  M(igrate) 
command  which  permits  migration  to  optical  disk;  ESCON  DASD  support;  and 
the  ability  to  change  the  attributes  of  archived  SYSOUTs. 

Enhancements  include:  asynchronous  database  REORG;  right-scrolling 
capabilities  from  primary  selection  lists;  online  database  statistics;  automatic 
selection  list  refresh;  VTAM  interface  and  error  recovery  capabilities;  cleanup 
processing  in  SARBCH  LOAD  and  non-shared  JES  environments;  flexible 
reprinting  in  Express  Delivery;  page  index  access;  retention  on  optical  disk;  and 
the  addition  of  the  LOCATE  field  in  the  logical  view  selection  panel. 


Improved  Performance 

The  internal  memory  management  algorithm  has  been  modified  which  results  in 
a  general  performance  improvement  in  all  aspects  of  the  product. 


AFP  Reports:  Archival 


You  can  now  archive  AFP  data  with  the  SAR  ACIF  interface.  Note  that  you  can 
use  the  SARPC  product  (Version  3.0  or  higher)  to  view  those  AFP  reports. 


New  Optical  Disk  Driver 

The  new  SARD2DOO  optical  disk  driver  allows  you  to  archive  to  IBM  DASD 
emulation  optical  devices  (including  the  ESA/370  and  ESA/390  3995  model  151 
Optical  Library  Dataserver)  with  page  level  access. 
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Asynchronous  Database  REORG 


The  REORG  function  of  the  SARDBASE  utility  no  longer  requires  exclusive 
access  to  the  database;  it  can' run  while  other  database  activities,  such  as  archiving 
or  backing  up,  are  occurring.  Additionally,  I/O  performance  has  been  enhanced 
significantly  because  the  number  of  I/O  operations  that  occur  has  been  reduced. 


SMS  Support  for  Database  Allocation 

The  SAR  database  can  now  be  allocated  imder  the  control  of  IBM's  data 
management  system,  SMS.  New  keywords  for  the  ADDDS  statement  of  the 
SARDBASE  utility  are  available  to  identify  storage  class,  etc. 


Scrollable  Selection  Lists:  More  information  Fields 

You  can  now  scroll  to  the  right  from  the  primary  selection  lists  for  many  new 
information  fields,  including: 

■  A  new  user  comment  field 

■  ERG  (Expanded  Retention  Option)  information 


Online  Database  Statistics 


A  new  online  command  displays  a  panel  showing  the  number  of  lines  on  DASD; 
the  DASD  usage,  and  the  number  of  reports  both  on  DASD  and  contained  in  the 
database. 


User  Defined  Exceptionai  Condition  Checking 

You  can  now  specify  character  strings  to  identify  exceptional  conditions. 

Once  recognized,  these  conditions  are  processed  in  the  same  way  as  the  system 
exception  checking,  via  table  SARXCTABj  A  new  user  exit  SARXCTUX,  has  been 
added  to  provide  further  user  control  of  exceptional  condition  processing. 


Automatic  Seiection  List  Refresh 

You  can  now  configure  SAR  so  that  whenever  you  press  ENTER>  the  selection  list 
is  re-evaluated  as  though  you  had  entered  the  REDISP  command.  This  can  be 
controlled  at  the  system-wide  level  by  the  REDISP  initialization  parameter,  or  at 
the  user  level  by  the  REDISP  line  command. 
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VTAM  Interface 

The  VTAM  online  interface  has  been  enhanced,  as  follows: 

■  The  VTAM  interface  has  been  installed  into  the  cross-memory  region;  this 
allows  one  region  to  support  CICS,  IMS,  and  VTAM  users  at  the  same  time. 

■  AR  cross-memory  operator  commands,  including  those  that  list  and  cancel 
users,.now  also  apply  to  the  VTAM  interface.  Additional  operator  commands 
are  also  available. 

■  The  VTAM  interface  now  supports  the  LONGWAIT  and  GANCEL 
parameters  so  users  who  exceed  a  specified  period  of  inactivity  may  be 
automatically  canceled. 

■  Multiple  VTAM  interface  regions  are  now  supported. 

■  Dynamic  logmode  support  has  been  enhanced. 

The  interface  supports  SNA  QLTERY  logmode  commands,  with  both  SAA 
and  non-SAA  terminals  supported. 

■  SYSPRINT  message  log  support  has  been  enhanced. 

Messages  generated  by  cross-memory  (SARXMS)  can  be  written  to  a 
SYSPRINT  file  wid\  time  stamps. 

■  User  CICS  menu  transaction  selection  list  has  been  enhanced. 

The  CICS  menu  transaction  list  has  been  extended  to  allow  the  automatic 
access  of  a  SYSOUT  selection  list  when  SAR  is  first  brought  up. 

Improved  VTAM  Error  Recovery 

The  VTAM  online  interface  error  recovery  capability  has  been  enhanced,  as 
follows: 

■  The  following  events  now  cause  a  CANCEL  operator  command  to  be  issued: 

-  LONGWAIT  parameter  exceeded  and  CANCEL  parameter  is  set  to  YES 

-  CICS  TIMEOUT  is  exceeded 

-  Various  VTAM  I/O  errors 

-  Control  block  errors 

■  Application  error  messages  (such  as  JOB  SUBN=D,  SAR  database  errors,  etc.) 
are  now  reported  in  the  output  message  log. 

■  ATTN  key  interrupts,  unexpected  VTAM  as5mch  errors,  and  logon  screen 
sizes  that  can  be  determined  with  an  SNA  QUERY  are  reported.  (ATIN  key 
interrupts  and  VTAM  asynch  errors  are  then  ignored). 
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■  VTAM  temporary  errors  are  ignored  and  not  reported.  If  the  SYSREQ  or 
TEST  keys  are  pressed,  the  last  screen  is  redisplayed  when  you  switch  the 
terminal  back  to  application  mode. 

■  If  there  is  a  terminal  power  failure,  or  COAX  cable  loss,  the  screen  is  re¬ 
displayed  once  per  second  for  2  minutes.  If  the  terminal  error  is  not  cleared 
by  then,  the  session  is  canceled. 

■  VTAM  error  codes  are  converted  to  text  before  being  issued  to  the  log. 


Cleanup  Processing:  SARBCH  LOAD 


SARBCH  LOAD  program  now  has  enhanced  cleanup  processing.  If  a  LOAD  job 
is  canceled  by  the  operator,  or  any  other  abend  occurs,  the  SYSOUT  that  was 
being  LOADed  goes  back  to  TAPE  status. 


Cleanup  Processing:  Non-Shared  JES  Environments 

If  you  run  in  a  non-shared  JES  environment,  the  SAR  backup  cycle  cannot  verify 
the  OPEN  status  of  an  Express  Delivery  direct-to-SAR  report.  CLEAN,  a  new 
initialization  parameter,  allows  you  specify  whether  the  SAR  backup  cycle 
should  process  these  reports.  If  CLEAN=NO  is  specified,  you  can  invoke  cleanup 
processing  manually  with  the  online  C  command,  or  the  F  SARSTC,  CLEAN 
operator  command. 


VM/XA  Support 


SAR  running  imder  VM  can  now  run  in  XA  mode. 


Express  Delivery  Report  Reprinting:  Flexible  Copies 

For  an  Express  Delivery  report,  the  flexible  number  of  copies  ("*"  for  copies  in 
the  Distribution  Identifier  panel)  is  honored.  The  asterisk  indicates  that  the 
number  of  copies  specified  in  the  JCL  that  originally  created  the  report  is  to  be 
used. 


Page  Index  Accessing  Enhanced 

The  page  separation  indexing  information  can  now  be  randomly  accessed.  It  is  no 
longer  necessary  to  read  in  tiie  entire  index  when  a  SYSOUT  is  selected  for 
browsing  or  printing. 
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This  change  eliminates  the  delay  experienced  when  selecting  a  very  large 
indexed  SYSOUT  for  browsing  or  printing  from  optical  disk.  In  addition,  storage 
allocation  is  decreased,  since  the  page  separation  index  is  no  longer  read  into 
memory. 

An  existing  SYSOUT  group,  archived  prior  to  this  release,  will  have  been  stored 
in  the  old  format.  When  selected  for  browsing  or  printing,  it  will  therefore  still 
require  the  reading  of  its  entire  page  separation  index  into  memory. 


Expanded  Retention  on  Optical  Disk  Enhanced 

Now  you  can  specify  retention  periods  by  SYSOUT  ID  for  reports  archived  to 
optical  disk.  The  DSK2DAYS  parameter  still  sets  the  default  retention  for  all 
reports  archived  to  optical  disk. 


Migrate  Command:  Optical  Disk  Archival 


The  M(igrate)  command,  a  new  line  command,  has  been  added  to  the  selection 
lists.  A  SYSOUT  is  migrated  to  optical  disk  with  the  next  SAR  backup  cycle  when 
an  M  command  is  issued  against  it. 


LOCATE  Field  in  Logical  View  Panel 

The  logical  view  selection  panel  now  contains  LOCATE,  a  new  input  field.  When 
selecting  a  logical  view  that  contains  a  page  separation  index,  you  can  enter  an 
initial  LOCATE  value  for  the  page  separation  index  selection.  LOCATE  works  as 
follows: 

■  If  an  exact  match  occurs  between  the  initial  LOCATE  value  and  a  page 
separation  index  value,  the  SYSOUT  is  displayed  directly;  the  page 
separation  selection  list  is  skipped;  otherwise,  the  page  separation  selection 
list  is  presented  and  positioned  as  if  you  had  entered  a  LOCATE  command 
with  the  value. 

■  If  you  specify  an  initial  locate  value  for  a  logical  view  that  does  not  contain  a 
page  separation  index,  the  LOCATE  value  is  ignored. 
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ESCON  DASD  Support 


SAR  now  exploits  Enterprise  Systems  Connection  (ESCON)  DASD  architecture. 


Changing  the  Attributes  of  Archived  SYSOUTs 

You  can  now  use  the  new  SARBCH  CBIANGE  control  statement  to  change  the 
attributes  of  SYSOUTs  that  have  already  been  archived  to  the  SAR  database.  You 
can  change  print  attributes,  backup  status,  and  user  fields. 
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Chapter  1 

Introducing  CA-View 


In  This  Chapter 

This  chapter  presents  an  overview  of  CA-View  processing  and  features. 


Oven^iew  of  CA-View 

CA-View  is  a  facility  that  archives  and  retrieves  computer  output  (SYSOUT).  Any 
SYSOUT  can  be  specified  for  archiving.  In  a  production  environment,  CA-View  is 
especially  weU-suited  to  the  management  of  the  foUowmg  classes  of  data: 

■  Production  JCL  listings  and  messages 

■  Production  reports 

■  SYSLOG  data 

SYSLOG  data  is  archived  whenever  it  is  queued  for  output.  The  automatic 
command  facility  can  be  used  to  queue  SYSLOG  data  at  regular  intervals. 
Production  reports  can  be  automatically  archived  and  printed.  Should  a  report 
get  lost  or  need  to  be  reprinted,  the  retrieval  system  reprints  it  from  archival, 
eliminating  the  need  for  reruns.  Large  reports  can  be  archived  directly  to  tape  to 
minimize  disk  requirements. 

When  a  job,  started  task,  or  time-sharing  session  has  output  queued  for 
processing,  any  output  meeting  the  archival  criteria  is  written  to  the  current  disk 
generation  (or  tape,  if  specified).  At  a  specified  time  (or  at  specified  intervals),  the 
current  generation  on  disk  is  backed  up  to  tape.  A  new  disk  generation  is  created, 
and  archiving  continues  with  this  new  generation. 
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Overview  of  CA-View 


Exceptional  Condition  Checking 


Using  GA-View,  production  JGL  listings  and  messages  can  be  automatically 
archived  and  retained  for  as  long  as  you  wanti  You  can  optionally  specify  tire 
action  to  take  whenever  an  exceptional  condition  is  encountered;  actions  include 
issuing  a  message  to  the  operator  and  printing  the  SYSOUT  for  the  job. 

CA-View  checks  for  the  following  exceptional  conditions; 

■  Non-zero  condition  code 

■  System  or  user  abend 

■  JCL  error 

■  Data  set  cataloging  error 

■  Data  set  not  deleted  error 

■  Operator  cancel  of  allocation  request 

■  User-specified  condition 

The  conditions  can  be  modified  as  needed  by  using  control  statement  inputs  to 
the  CA-View  started  task  (SARSTC). 


Retention  and  Retrieval 

Compilation  listings,  production^  reports,  and  SYSOUT  can  be  retained  on  a  long¬ 
term  basis  on  disk  or  tape  as  a  feature  of  the  Expanded  Retention  Option. 

You  can  retrieve  SYSOUT  easily  from  an  online  terminal  using  the  online 
retrieval  facility.  You  can  select  one  or  aU  generations  of  archived  SYSOUT.  You 
are  presented  with  a  selection  list  of  the  SYSOUT  groups  (a  group  of  data  sets 
having  the  same  job  name)  to  which  you  are  authorized  access. 

You  can  select  a  SYSOUT  group  for  browsing  or  printing  and  can  scroll  through 
the  SYSOUTs  using  the  CA-View  Browse  facility's  SYSOUT  indexing  and  logical 
view  features,  which  allow  you  to  automatically  display  only  the  portion  of  a 
SYSOUT  that  you  need.  You  can  also  search  for  specific  character  strings  with  the 
FIND  command. 

Full  batch  retrieval  capability  is  also  provided  with  the  SARBCH  utility. 
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Downloading  and  Printing 

With  CA-View,  you  can  do  the  following: 

■  Transmit  and  download  SYSOUT  data  to  a  personal  computer  running 
CA-DocView  (formerly  GA-View  Workstation),  a  separate  product  that  runs 
on  a  PC  with  Windows  95  or  Windows  NT 

■  Print  to  VTAM  printers  via  the  CA-View  VTAM  Print  option  and  CA-Spool 

■  Print  to  other  external  printing  products  with  the  External  Printing  Interface 


General  Processing  information 

SYSOUT  Groups  SYSOUT  is  archived  in  imits  called  SYSOUT  groups.  A  SYSOUT  group  is 

comprised  of  all  SYSOUT  data  sets  for  a  job  having  the  same  characteristics 
(for  example,  the  same  SYSOUT  ID,  the  same  SYSOUT  class,  the  same  forms 
name,  and  the  same  FCB).. 

Each  individual  SYSOUT  group  is  assigned  a  1-  to  12-character  name  referred  to 
as  the  SYSOUT  ID:  The  default  ID  assigned  to  a  SYSOUT  group  is  its  job  name. 
You  can  override  the  default  ID  for  a  SYSOUT  group  by  coding  another  name  as 
the  second  positional  parameter  of  the  SYSOUT  parameter  on  its  DD  statement. 
The  ID  is  coded  as  a  1-  to  8-character  program  name  conforming  to  standard  JCL 
syntax  rules. 

Syntax  sysout= ( class, id, form) 

Specifying  a  dollar  sign  as  the  first  character  of  the  program  name  indicates  that 
the  remaining  characters  of  the  name  are  to  be  appended  to  the  job  name  to  form 
the  SYSOUT  ID.  If  the  resulting  ID  is  longer  than  12  characters,  it  is  truncated  on 
the  right. 

Two  other  national  characters — ^the  at  sign  (@)  and  poimd  sign  (#) — are  reserved 
by  CA-View,  and  should  not  be  used  as  the  first  character  of  the  program  name. 

Record  Length  The  logical  record  for  reports  processed  by  CA-View  cannot  exceed  32752  for 

fixed-length  records  or  32756  for  variable-length  records.  This  includes  the 
carriage  control  character. 
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Example  of  SYSOUT  ID  Assignments 

The  following  example  assumes  the  following  DD  statements  are  contained  in  a 
job  named  PRODJOBi 

//DDl  DD  SYSOUT=A 

//DD2  DD  SySOUT=(A,REFORTl) 

//DD3  DD  SYSOOT=(A,$Rl) 

//DD4  DD  SySOUT=  (A,  $TOOIiONG)) 

The  SYSOUT  IDs  that  are  assigned  to  data  sets  are: 


DD  name 

SYSOUT  ID 

DDl 

PRODJOB 

DD2 

REPORTl 

DD3 

PRODJOBRl 

DD4 

PRODJOBTGOLO 

Other  Features 


User  Exits 


Alternate  Date 
Format 


CA-View  Printing 
Capabiiities 


CA-View  provides  a  number  of  user  exits  that  allow  you  to  tailor  the  product  to 
meet  your  site's  requirements.  These  user  exits  are  links  to  the  CA-View  source 
code. 

The  default  date  format  for  all  dates  is  mm/dd/yy  (month,  day,  year).  You  can  set 
an  alternate  format  of  dd/mm/yy.  The  mm/dd/yy  format  is  used  throughout  the 
CA-View  documentation. 

The  printing  capabilities  provided  by  CA-View  include  the  ability  to  specify 
variables  that  range  from  Imes-printed  and  pages-printed  limits  to  multiple 
printer  systems.  CA-View  allows  you  to  print  to  standard  printers  and  VTAM 
printers;  it  also  allows  you  to  print  through  CA-Spool.  An  External  Printing 
interface  is  also  provided  to  print  to  other  products. 
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PC  Transmission 


Double-Byte 
Character  Sets 
(DECS) 


Support  is  provided  for  transmittmg  (or  downloading)  SYSOUT  data  to 
CA-DocView  (formerly  CA-View  Workstation)^  a  product  that  runs  on  a  PC 
under  Windows  95  or  Windows  NT. 

A  SYSOUT  group  is  queued  for  transmission  to  your  PC  session  by  printing  it  in 
batch  mode  or  online  via  the  J  or  P  SYSOUT  selection  code.  From  the  Print 
Attribute  Panels  that  are  displayed  by  these  options,  you  specify  a  destination  of 
PC  as  follows: 

DEST  ===>  pc 

To  queue  a  SYSOUT  group  for  transmission  to  another  user's  PC  session,  you 
append  a  period  and  the  user's  ID  to  the  destination  PC.  For  example,  to  queue  a 
SYSOUT  group  to  user  TOM,  specify: 

DEST  ===>  pc. tom 

Alternatively,  you  can  use  a  device  synonym  as  specified  using  the  Define  Device 
command. 

As  with  printing  a  SYSOUT  group,  you  can  modify  the  page  format  by  specifying 
a  logical  view,  and  you  can  limit  the  data  that  is  transmitted  by  specifying  ranges 
of  pages  or  records. 

CA-View  provides  support  for  DECS  characters  such  as  Chinese,  Japanese,  or 
Korean.  For  CA-View  to  recognize  and  process  DECS  data,  you  must  ensure  the 
following: 

■  DECS  data  is  enclosed  by  shift  out  (X'OE')/ shift-in  (X'OF')  characters 

■  Shift-out/shift-in  pairing  is  completed  in  each  logical  record 

■  PRMODE=SOSIi  or  PRMODE=SOSI2  is  specified  for  the  data  set  in  its 

/  /OUTPUT  statement  (an  lEM  requirement  for  printing  to  a  3800  printer) 

Note:  For  JES3,  the  PKMODE  parameter  is  only  available  to  CA-View  when 
a  data  set  is  archived  by  the  automatic  report  archival  feature  of  CA-View 
system  extensions,  or  by  the  direct-to-CA-View  archival  feature  of 
CA-Deliver. 

You  can  view  DECS  data  only  on  a  workstation  that  provides  DECS 

input /output  capability  such  as  3270  information  display.  Currently,  only  the 

ISPF  and  Native  TSO  online  retrieval  options  support  the  viewing  of  DECS  data. 

To  reprint  a  SYSOUT  group  containing  DECS  data,  you  can  use  selection  code  J 
from  online  retrieval  or  the  batch  retrieval  print  function.  The  printer  to  which 
the  output  is  directed  must  be  controlled  by  the  Print  Services  Facility  (PSF). 
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Chapter  2 

Initialization  Parameters 


in  This  Chapter 

This  chapter  explains  how  to: 

■  Set  and  change  initialization  parameters,  which  control  the  CA-View 
customization  options 

■  Set  and  change  the  expanded  retention  initialization  parameters 


Setting  and  Changing  Initialization  Parameters 

The  SAREMIT  program  sets  or  changes  initialization  parameters  in  the  CA-View 
database.  Using  these  parameters,  you  can  modify  the  CA-View  customization 
options. 


Job  Control  Statements 

The  following  job  control  statements  are  required  to  execute  SARINIT: 


Statement 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARINIT)  and, 
optionally,  the  high-level  name  of  the  CA-View  database 
as  the  PARM  parameter  (PAEM=dbname) 

STEPLIB  DD 

Defines  the  load  library  containing  SARINIT 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRINT  DD 

Defines  the  sequential  output  data  set  used  for  listing  the 
statements  and  messages 

If  this  is  not  a  SYSOUT  data  set,  DCB=BLKSIZE=nnn  must 
be  coded,  where  nnn  is  a  multiple  of  121. 

Continued 
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Continued 

Statement 

Description 

SYSIN  DD 

Defines  a  card  image  data  set  containing  the  parameter 
statements 

Initialization  Parameter  Descriptions 

The  SARINIT  program  reads  a  set  of  parameter  statements.  For  a  new  database,  it 
initializes  a  new  Master  Control  Record  (MGR)  and  writes  it  out  to  the  master 
index.  If  a  statement  for  one  of  the  parameters  is  omitted,  default  values  are  used. 

For  an  existing  database,  SARINIT  updates  the  existing  MCR.  Any  parameter  for 
which  a  statement  is  provided  is  set  to  the  value  supplied.  If  a  parameter 
statement  is  supplied  without  a  value,  the  parameter  is  set  to  its  default  value. 
Any  parameter  for  which  no  statement  is  supplied  remains  unchanged. 

The  archival  started  task  (SARSTC)  must  be  stopped  before  changing  any 
parameters  in  its  master  index. 


Format  of  SARINIT  Statements 

Parameter  statements  are  coded  as  card  images  and  have  the  following  format: 

parameter= value 

■  The  parameter  must  begin  in  column  1,  followed  by  an  equal  sign  and  the 
value  to  be  assigned  to  the  parameter. 

■  No  blanks  can  be  coded  between  the  parameter  and  the  equal  sign  nor 
between  the  equal  sign  and  the  value. 

■  Only  one  parameter  can  be  coded  per  card  image. 

■  Comments  can  be  included  within  the  parameter  statements  by  coding  an 
asterisk  in  colvuxm  1  of  the  card  image  containing  the  comment. 


CA-ACF2 


This  parameter  specifies  whether  GA-View  performs  CA-ACF2  security  checking 
when  retrieving  individual  SYSOUT  groups.  This  parameter  supplies  the  high^ 
level  index  used  to  define  the  SYSOUT  group  to  CA-ACF2  and  is  mutually 
exclusive  with  the  RACF  parameter. 


Syntax 


AGF2  =  jexjcxxx 


There  is  no  default. 
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ACF2SCC 


Syntax 


This  parameter  specifies  the  number  of  the  CA-ACF2  validate  security  interface 
SVC.  This  parameter  has  no  meaning  unless  the  CA-AGF2  parameter  is  specified. 


AGF2SVG=jmn 
The  default  is  255. 


ACIFRES 


Syntax 


ANNOTATE 


Syntax 


This  parameter  specifies  whether  CA-View  should  reprint  AFP  reports  with 
embedded  resources,  allowing  CA-View  to  manage  the  resources  associated  with 
a  report. 


AGXFR£S=YES|N0 


The  default  is  YES. 

YES  Reprints  AFP  reports  with  embedded  resources,  even  if  a  resource  on 
your  system  has  been  updated  since  the  report  was  archived 

CA-View  will  use  the  appropriate  older  resource  at  reprint  time. 

NO  CA-View  reprints  AFP  reports  without  embedded  resources. 


This  parameter  sets  default  annotation  on/off  mode. 

ANNOTATE^ON | OFF 

The  default  is  OFF. 

Values  are  as  foEows: 

ON  Displays  reports  with  annotation  on 
OFF  Displays  reports  with  annotation  off 

You  can  use  the  ANNOTATE  command  when  you  are  browsing  reports. 


ARCHMSG 


This  parameter  specifies  whether  the  SARSTC22  archival  message  is  issued. 


(  I 
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Syntax 

ARCHSWAP 

Syntax 

BCHMAXRC 

Syntax 

CCONDISP 

Syntax 


ARCHHS6=YSS | 


The  default  is  NO; 


This  parameter  specifies  whether  the  CA-View  started  task  is  swappable. 

ARGHSWAP=YES | NO 

The  defaxilt  is  NO; 

Values  are  as  follows: 

YES  Marks  the  started  task  as  swappable 
NO  Marks  the  started  task  as  non-swappable 


This  parameter  specifies  the  maximiun  return  code  that  the  SARBCH  program 
will  issue. 


BCHMAXRC  =zum 


The  maximum  is  255. 


This  parameter  specifies  CA-View's  system-wide  default  value  that  controls  the 
viewing  of  carriage  control  characters  in  onUne  logical  viewing. 

CCONDISP=YES I  NO 

The  default  is  YES. 

Values  are  as  follows; 


YES  Sets  the  carriage  control  character 
viewing 

NO  Sets  the  carriage  control  character 
viewing 


viewing  default  to  YES  for  online 
viewing  default  to  NO  for  online 
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CLEAN 

This  parameter  specifies  whether  the  CA-View  backup  cycle  will  invoke  cleanup 
processing  of  CA-Deliver  direct-to-CA-View  reports  with  OPEN  status. 

Ci:iEAN=YES  I  NO 

The  default  is  YES. 

Values  are  as  follows: 

YES  Specifies  cleanup  processing 

NO  Specifies  no  cleanup  processing 

Sites  that  run  in  a  non-shared  JES  environment  should  set 
CLEAN=NO>  because  CA-View  cannot  determine  if  the  report  was 
left  in  OPEN  status  or  if  it  is  actually  being  processed. 

Note:  If  GLEAN=NO,  cleanup  must  be  done  manually  with  the  online  C 
command,  or  with  the  following  operator  command: 

F  SARSTC,  CLEftH 

o 

CLSL 

This  parameter  specifies  a  list  of  1  to  8  SYSOUT  classes  used  to  select  SYSOUT  for 
archival.  When  CLSL  is  specified,  NEWCLSL  should  also  be  specified  to  prevent 
a  print-archival-print  loop.  If' neither  CLSL,  DEST,  nor  FORM  is  specified,  all 
SYSOUT  is  archived. 

Syntax  CLSL=jcxaaoa«cx 


Syntax 


The  default  is  ALL  CLASSES. 


CMAMAX 


This  parameter  specifies  file  maximiun  number  of  lines  that  can  be  printed  when 
using  CA-Spool. 


Syntax 


CMAMAX=mirm 


The  default  is  5000. 

The  minimum  value  is  1;  the  maximum  value  is  16770000. 


Initialization  Parameters  2-5 


Initialization  Parameter  Descriptions 


CMASPOOL 


Syntax 


CODEPAGE 


Syntax 


DAYS 


Syntax 


This  parameter  specifies  the  name  of  the  CA-Spool  subsystem  and  corresponds  to 
the  CA-Spool  SUBID  configuration  parameter  located  in  member  ESFPARM. 
CMASPOOL  is  used  when  printing  using  CA-Spool. 

cts&s'BOOii=siibsys 
There  is  no  default. 


This  parameter  specifies  which  translation  table  (or  codepage)  CA-View  is  to  use. 
The  table  is  used  to  map  nomdisplay  characters,  or  characters  needed  for  a 
particular  language. 

CODEPAGE  =3atX 

The  default  is  037. 

The  tables  are  named  EBCCPxxa:  with  the  xxx  characters  being  unique  for 
different  tables.  The  translation  tables  supplied  on  the  CA-View  distribution  tape 
are  shown  after  the  default  value  for  this  parameter. 


This  parameter  specifies  a  string  of  seven  characters  with  each  character 
corresponding  to  one  day  of  the  week  from  Monday  through  Sunday.  Each  of  the 
characters  is  specified  as  either  Y  or  N. 

OAYS=3aaaaaae 

The  default  is  YYYYYYY. 

Y  Specifies  that  the  backup  cycle  can  be  automatically  initiated  by 
CA-View  on  that  day  of  the  week 

N  Suppresses  the  automatic  backup  cycle  on  that  day  of  the  week 
See  the  TIME  command  later  in  this  chapter  for  more  information. 
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^  DBMSGFRQ 

This  parameter  specifies  the  frequency  or  interval  (from  1  to  65535)  in  nrimber  of 
records  at  which  console  messages  are  produced  with  the  SARDBASE  utility. 

Syntax  DBMSGFRQ=jiniin 

The  default  is  5000. 

Following  are  the  console  messages  produced  with  the  SARDBASE  utility: 

SARBKT63  STANDARD | imSRZM  PHASE  n  PROCESSING  rrrrrr, 

ARCHIVED  ON  date  AT  time 

SARDB605  REORGANIZING  johname,  GW=gen,  ARCHIVED  ON 
date  AT  time 

SARDBR03  ATTEMPT  TO  COPY  SYSOUT  GROUP  FROM  OLD  DATA 
BASE  -  ID=id^  GEN=gren j  SEQ=seg' 

SARDBR20  SYSOUT  GROUP  ADDED  TO  INDEX  -  ID=id, 

GEN=sren,  SEQ=seg 

SARDBVll  INDEX  VERIFICATION  FOR  ID=id,  GEN=ffen,  SEQ=seg 


DBTHRESH 

This  parameter  specifies  a  threshold  percentage  of  database  capacity. 

Syntax  dbthresh=jiii 

y  The  default  is  80. 

When  the  threshold  is  reached,  the  following  message  displays: 

SARDBI23  xxxxxxx  DATABASE  IS  AT  nn%  UTILIZATION 


DEFMODE 

This  parameter  specifies  the  system  default  user  mode  used  for  new  users.  This 
default  user  mode  applies  to  new  users  who  have  not  been  predefined  to  the 
CA-View  system  by  the  DEF  USER  command. 

Syntax  DEFMODE=abcde 

The  defaxilt  is  YNNNN.. 

Each  position  is  specified  as  follows: 

Y  The  user  can  enter  a  specific  online  operating  mode 

N  The  user  cannot  enter  a  specific  online  operating  mode 

D  The  default  mode  for  a  first-time  user 

If  there  are  multiple  Ds,  the  first  one  is  used.  If  there  is  no  D,  the  first  Y 
is  used  to  indicate  the  initial  mode  for  a  first-time  user. 
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DELETE 

Syntax 

DESC 

Syntax 

DEST 

Syntax 


If  DEFMODE=NNNNN  is  specified,  no  new  users  will  be  permitted.  The 
following  table  explains  the  values  for  a,  b,  c,  d,  e  in  the  parameter  statement; 


Reference  Letter 

Mode 

Values 

a 

ALL 

YIN  ID 

b 

Express  operations 

YINID 

c 

Express 

YINID> 

d 

SAR  operations 

YINID 

e 

SAR 

YINID 

For  example,  DEFMODE=YNNNN  means  Yes  for  ALL  mode  and  No  for  the 
remainder  of  the  modes. 


This  parameter  specifies  whether  SYSOUT  groups  can  be  deleted  by  online  users. 
DEliETE=yES  I  NO 

The  default  is  NO. 


This  parameter  specifies  the  descriptor  code  used  for  exceptional  condition 
messages  (message  ID  SAI^TC99). 


□ESC=i3Jl 


The  default  value  is  2. 

The  default  value  highlights  the  messages  and  prevents  them  from  rolling  off  a 
console  in  roll-delete  mode.  A  value  of  7  allows  the  messages  to  roll  off  and  be 
deleted.  See  the  ROUT  command  later  in  this  chapter  for  more  information. 


This  parameter  specifies  the  destination  (remote  name)  used  to  select  SYSOUT 
for  archival. 

ViE,S'S=iaaat3aaat 

The  default  is  ALL  DESTINATIONS. 
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DIRALLOC 


Syntax 


EASTDPLX 


Syntax 


EASTMAXW 


Syntax 


When  DEST  is  specified,  MEWDEST  should  also  be  specified  to  prevent  a  print- 
archival-print  loop.  If  neitiier  GLSL,  DEST,  nor  FOKM  is  specified,  all  SYSOUT  is 
archived. 


This  parameter  specifies  the  number  of  blocks  allocated  for  CA-Deliver-direct-to- 
CA-View  archival. 


OZSALLOC  =anan 


The  default  is  50. 

The  larger  the  value,  the  fewer  the  number  of  times  large  reports  archived  via 
CA-Deliver  direct-to  CA-View  archival  will  have  to  request  additional  blocks. 
The  lower  the  value,  the  greater  the  chance  of  archiving  into  a  database  which  is 
near  capacity. 


This  parameter  specifies  whether  SAREAS  will  try  to  access  a  duplex  volume  if 
the  primary  volume  is  not  cataloged.  EASTDPLX=YES  is  normally  used  in  a 
disaster  recovery  situation,  where  the  primary  volumes  no  longer  exist  or  are 
inaccessible. 

EASTDFLX=7ES | NO 

The  default  is  NO. 


This  parameter  specifies  the  length  of  time  to  wait  (in  minutes)  before  time-outs 
are  to  occur  for  online  requests  to  the  SAREAS  tape  server. 

BASTHAXW=nn 

The  default,  EASTMAXW=00,  indicates  no  time-outs  are  to  occur. 
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EASTNAM1 


Syntax 


EXPDT 


Syntax 


toEASTNAM3 

These  parameters  allow  reference  to  a  maximum  of  three  expanded  access 
servers  for  tape  and  robotics  when  accessing  report  data  that  resides  on  tape  or 
tape  emulation  optical  (see  Chapter  3;  "Configuring  CA-View,"  for  more 
information).  The  EASTNAMn  parameters  specify  the  subsystem  names  of  the 
expanded  access  servers  and  related  rmit  names  used  by  the  expanded  access 
server.  The  S5mtax  is  as  follows; 

EASTN&Hnsaas-aama/eaS'-imitl,  eas-imit2 


where: 

n 

Specifies  a  nrunber  (from  1  to  3)  used  to  reference  up  to  three 
expanded  access  servers 

eas-name 

Specifies  the  four-character  subsystem  name  of  the  expanded 
access  server 

eas-unitl 

Specifies  the  optional  unit  name  referenced  in  a  STORGRPn 
parameter  that  can  be  accessed  by  the  expanded  access  server 

eas-unit2 

Specifies  the  optional  second  urut  name  referenced  in  a 
STORGRPn  parameter  that  can  be  accessed  by  the  expanded 
access  server 

If  both  gfls-unzfl  and  eas-unit2  are  omitted  in  a  EASTNAMn  parameter,  all  imit 
names  not  specifically  identified  by  another  EASTNAMn  parameter  can  be 
accessed  by  this  expanded  access  server  subsystem; 

The  EASTNAMn  parameter  fields  must  be  specified  in  full.  Individual  parameter 
field  updates  are  not  supported. 

You  can  nullify  or  remove  an  EASTNAMn  parameter  by  specifying  no 
parameters.  For  example: 

E&STNA112  = 

There  is  no  default  expanded  access  server  subsystem. 


This  parameter  specifies  the  expiration  date  (mutually  exclusive  with  the  RETPD 
parameter)  used  for  allocating  a  new  tape  data  set;  The  most  recently  entered 
option  (EXPDT  or  RETPD)  takes  precedence  over  the  other. 


EXPDT=yyddd 

EXPTlT=yyyyddd 
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Two  forms  of  the  expiration  date  are  provided  for  compatibility  with  IBM 
expiration  date  specifications.  Use  of  the  yyyydt/d  form  requires  a  level  of  the 
MVS  operating  system  tlrat  provides  Year  2000  support.  A  comparable  level  of 
your  tape  management  product  may  also  be  needed. 

Some  tape  management  products  apply  special  meaning  to  certain  expiration 
date  specificatiojis.  For  example,  an  expiration  date  of  99000  is  used  by  many  tape 
management  products  to  indicate  catalog  retention  (retain  the  tape  as  long  as  it  is 
catalogued).  Catalog  retention  is  recommended,  since  all  backup  tapes  are 
catalogued  while  imder  the  control  of  CA-View. 

There  is  no  default  expiration  date;  the  suggested  value  is  99000. 


EXPOPRV 

This  parameter  specifies  whether  reprints  requested  in  Express  Operator  (EXPO) 
mode  go  to  only  the  user  requesting  the  reprint,  or  to  the  entire  distribution  list 
for  the  report. 

Syntax  EXPOPRV=-5fES  I  NO 

The  default  is  NO. 


EXPRESS 


Syntax 


This  parameter  specifies  the  high-level  name  of  the  CA-Deliver  database. 

EXPRESS=iiidex 

There  is  no  default. 
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EXTPRTn 


Syntax 


This  parameter  specifies  the  interface  and  attributes  for  printing  or  routing 
SYSOUT  to  an  external  printing  product. 


EX.TSRTn=printer-id/imsi>S/clas3/de3tination/form/wr±ter 

EXTPRTn=priiit!er-id/P6M/prosrrain-naine/paraaieter-data 


There  is  no  default 


The  second  parameter  (JESDS  or  PGM)  determines  which  interface  you  use— JES 
data  set  or  dynamic  program.  Refer  to  External  Printing  in  Chapter  3, 
"Configuring  CA-View,"  for  further  details. 

In  addition  to  specifying  a  1-  to  3-character  identifier  for  the  printing  product, 
each  EXTPRTn  parameter  contains  attributes  for  defining  the  commtmication 
mechanism.  Attributes  are  also  specified  by  the  online  DEFINE  DEVICE 
command. 

The  EXTPRTn  parameters  are  as  follows: 


n 

Specifies  either  1, 2,  or  3 

printer-id 

Specifies  the  1-  to  3-character  identifier  for  the  external 
print  product 

program-name 

Specifies  the  8-character  name  of  the  interface  program  to 
be  called 

class 

Specifies  the  l-character  SYSOUT  class  to  be  used  to  route 
the  external  print  record 

destination 

Specifies  the  8-character  SYSOUT  destination  to  be  used 
to  route  the  external  print  record 

form 

Specifies  the  4-character  SYSOUT  forms  name  to  be  used 
to  route  the  external  print  record 

writer 

Specifies  the  8-character  SYSOUT  writer  name  to  be  used 
to  route  the  external  print  record 
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Syntax 


FINDLIM 


Syntax 
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parameter-data  Specifies  up  to  14  characters  of  parameter  data  to  be 

passed  to  the  interface  program 

JESDS  For  the  JESDS  parameter  specification,  one  or  more  of  the 

EXTPRTn  options  can  be  specified  as  an  asterisk  (*)  to 
indicate  that  they  are  to  be  supplied  online  by  the  user 
when  printing  a  SYSOUT  group.  These  options  are: 

class 

dest 

form 

writer 


This  parameter  specifies  whether  CA-View  users  can  use  the  LAST  operand  with 
the  FEND  command  during  an  online  session. 

FINDIAST=YES  |  NO 

The  default  is  YES. 


This  parameter  limits  the  number  of  records  searched  before  CA-View  requires 
the  user  to  re-invoke  the  online  FIND  command.  A  user  can  use  the  LIMIT  online 
command  to  set  his/her  own  FINDLIM,  and  the  online  LIMIT  overrides  the 
FINDLIM  parameter. 


FINDLIM=IU3n,  max-nnn 


The  default  is  0. 

The  maximum  override  allowed  by  any  user  is  set  with  the  max-nnn  value.  A 
FINDLIM  of  0  permits  unlimited  searches.  The  maximum  value  is  65535. 

For  example,  you  can  have  a  default  FINDLIM  of  1,000  records  and  allow  users  to 
override  this,  but  not  to  exceed  a  FINDLIM  of  3,000  by  specifying 
FINDLIM=1000,3000. 
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FINDPREV 


Syntax 


FORM 


Syntax 


FREEPRT 


Syntax 


This  parameter  specifies  whether  CA-View  users  can  use  the  PKEV  operand  with 
the  FIND  command  during  an  online  session. 

FlNDPREV=yES | NO 


The  default  is  YES. 


This  parameter  specifies  the  forms  name  used  to  select  SYSOUT  for  archival. 
When  FORM  is  specified,  NEWFORM  should  also  be  specified  to  prevent  a  print- 
archivahprint  loop.  If  neittier  GLSL,  DEST,  nor  FORM  is  specified,  all  SYSOUT  is 
archived. 


The  default  is  ALL  SYSOUT  FORMS. 


This  parameter  specifies  whether  CA-View  uses  FREE=GLOSE  during  dynamic 
allocation  of  the  SYSOUT  data  set  for  the  print  function  of  SARBCH. 

FIlEEPRT='Xi:S  I  NO 

The  default  is  YES. 

Values  are  as  follows: 

YES  Specifies  FREE=CLOSE 

NO'  Does  not  specify  FREE=CLOSE 


With  FREEPRT=YES,  each  report  is  explicitly  freed  and  is  immediately  available 
to  be  printed.  With  FREEPRT=NO>  each  report  is  held  imtil  the  entire  SARBCH 
job  completes. 
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GEN 

This  parameter  specifies  the  starting  generation  niomber  to  be  established  for  a 
new  database. 

Syntax  GEN=nnn 


The  default  is  1. 

The  minimum  value  is  1;  the  maximum  value  is  32767. 


Warning!  You  should  modify  this  parameter  only  with  the  direction  of  a 
Computer  Associates  Technical  Support  representative. 


GRPUSER 


Syntax 

U 


This  parameter  specifies  whether  the  GGRUSER  field  should  be  used  as  a 
parameter  when  CA-View  checks  for  a  new  SYSOUT  group. 

grpusersyesIno 

The  default  is  NO; 

Values  are  as  follows: 

YES  Use  the  GCRUSER  field  in  addition  to  all  other  criteria 

If  the  GGRUSER  field  changes  within  a  SYSOUT  group,  the  CA-View 
started  task  will  split  it  into  a  new  entry  in  the  CA-View  database. 

NO  Do  not  use  the  GCRUSER  field 


HOLDTEMP 


This  parameter  specifies  the  number  of  backup  cycles  a  SYSOUT  is  held  (after  a 
load/ restore)  before  it  is  deleted  from  disk.  This  is  a  temporary  data  set  hold. 
Both  primary  and  interim  backups  are  included. 

Syntax  holdtempsxxx 

The  default  is  0. 


I 
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INTERVAL 

Syntax 

JCLASS 

Syntax 

JES2LVL 

Syntax 


This  parameter  specifies  the  time  interval  in  hours  and  minutes  after  which  the 
backup  cycle  is  automatically  initiated. 

IKfTERVAL=ii&]mn 

The  default  is  2400. 

Values  are  as  follows: 

hh  Specifies  the  hour,  based  on  a  24-hour  clock 
mm  Specifies  the  minutes 

See  the  TIME  command  later  in  this  chapter  for  more  information. 


This  parameter  determines  the  SYSOUT  class  to  appear  on  the  Print  Attribute 
panel  when  a  SYSOUT  is  printed  with  the  online  J  selection  code. 

JGLASS=* 

The  default  is  TSOCLS/NEWGLSL. 

You  do  one  of  the  following: 

■  Specify  an  asterisk  (JGLASS=*)  to  use  the  MSGGLASS  from  the  original 
SYSOUT  job 

■  Leave  the  field  blank  to  default  to  the  TSOGLS  initialization  parameter 
specification. 

If  TSOGLS  is  left  blank,  then  the  NEWGLSL  initialization  parameter 
specification  is  the  default. 


This  parameter  specifies  the  levelof  JES2  with  which  GA-View  is  interfacing. 

JE  S  2  XiiVli 

The  default  is  2. 
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The  valid  level  niimbers  are  as  follows: 


Level  Number 

JES2  Release 

0 

User  assembled 

1 

4.1  NJE  to  SP  1.S.2 

2 

SP  1.S3  to  SP  2.2.0 

S 

SPSl.l 

4 

SP  S.l.S 

5 

SP4.0toSP5.1 

For  sites  that  have  modified  the  JES2  system  so  that  the  JES2  control  blocks  are 
not  IBM^supplied  (specifically  the  SDB  and  PDDB  JES2  control  blocks),  you  can 
specify  JES2LVL=0.  In  this  case,  assemble  user  exit  SARJS2UX  with  your  JES2 
source  library. 

Note:  If  you  run  JES3,  you  do  not  need  to  specify  this  parameter. 


JES3ID 

This  parameter  specifies  an  alternate  subsystem  ID  for  JESS.  You  should  specify 
this  parameter  only  when  the  JESS  subsystem  is  used  and  the  subsystem  ID  is  not 
JESS. 

Syntax  JES3  XD=iiame 

The  default  is  JESS. 


LANGUAGE 


This  parameter  specifies  the  system  default  language  to  be  used  when  displaying 
online  panels  and  messages. 

Syntax  ijuigoage=j£ 

The  default  is  R. 
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LGNRETRY 


Syntax 


LOGO 


Syntax 


MASTER 


Syntax 


Values  are  as  follows: 


R  (or  blank)  English 

C  Canadian  French 

E)  Danish 


G 


German 


This  parameter  specifies  the  number  of  logon  failures  before  a  user  is  forced 
offline. 

LGHKETRY  =rmnn 

The  default  is  3. 


This  parameter  specifies  whether  the  initial  CA-View  logo  panel  is  displayed 
when  the  user  first  enters  the  CA-View  system. 

logo=yes|no 
The  default  is  YES. 


This  parameter  specifies  the  user  ID  of  the  CA-View  user  who  will  have  master 
authority.  Master  authority  allows  you  to  issue  the  DEF  USERcommand,  and  to 
define  access  authority  for  all  CA-View  users. 

HASTER=userid /ALL 

The  default  is  MASTER=ALL. 

MASTER=ALL  indicates  no  restrictions,  so  that  all  users  have  master  authority.  A 
user  with  master  authority  can  assign  master  authority  to  any  other  user,  with  the 
DEF  USER  command. 

See  the  section  on  the  Define  User  command  in  the  System  Administration 
chapter  of  the  CA-View  Online  User's  Guide  for  more  information. 
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MAXLINES 


This  parameter  specifies  the  maximum  number  of  lines  to  be  archived  per 
SYSOUT  group. 


Syntax 


=iinn^  BYPASS  ,  xxxx 


The  default  is  0. 

Values  are  as  follows: 

nnn  Specifies  the  maximtom  amount  of  lines  to  be  archived  per  SYSOUT 

group 

Valid  values  are  1  to  16777216.  A  value  of  0  indicates  that  there  is  no 
limit  for  the  reports. 

BYPASS  Specifies  (as  an  optional  parameter)  that  any  lines  in  excess  of  the 
number  (nnn)  in  a  SYSOUT  group  wiUbe  deleted  without  archival 

If  left  blank,  the  lines  in  excess  of  nnn  are  passed  to  the  user  exit 
SARSTCUX  for  processing. 

xxxx  Specifies  for  the  direct-to-CA-View  archival  feature  of  CA-Deliver, 
the  maximum  number  of  lines  to  be  archived  per  report 

Valid  values  are  1  to  16777216.  A  value  of  0  indicates  that  there  is  no 
limit  for  the  reports.  Records  in  excess  of  the  specified  limit  are 
discarded. 

Omitted  values  (as  in  MAXLINES=„50000)  are  set  to  the  default  values,  not  to  the 
value  set  in  the  previous  run. 


MOUNT 


Syntax 


This  parameter  specifies  whether  online  tape  mounts  are  allowed. 

mount=yes|no 
The  default  is  YES. 

Values  are  as  follows: 

YES  Allows  online  tape  mounts 

For  native  TSO  and  SPF/ISPF,  when  you  specify  this  option,  the  user 
attributes  (UADS)  for  the  user  determines  whether  online  tape  moxmts 
will  be  allowed. 

NO  Prevents  online  tape  mounts 
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MSORTl 


Syntax 


to  MSORT5 

This  parameter  specifies  the  name  of  the  first  field  to  be  sorted  by  the  microfiche 
format  program. 

KSORTl=3aaexxxx 
HSORT2  =3aaaex3cx 
HS0RT3  =3aaaaexx 
HSORT4  =3tXX3CX3CX 
MS0RT5=ja£XJE}£xx 

Additional  fields  to  be  sorted  are  specified  by  MSORT2,  MSORT3,  MSORT4,  and 
MSORT5.  These  parameters  determine  the  order  in  which  SYSOUT  is  output  to 
microfiche.  The  field  is  sorted  in  ascending  order. 

To  have  the  microfiche  program  sort  the  field  in  descending  order,  precede  the 
name  by  a  minus  sign  (for  example,  MSORTl=-JNAME).  The  field  names  you  can 
specify  are  shown  in  the  following  table. 

Note:  If  no  sort  parameters  are  specified,  the  microfiche  format  program  will' 
output  SYSOUT  in  ascendmg  order  by  SYSOUT  identification,  and  then 
descending  order  of  date  and  time  of  archival. 

Valid  field  names  for  xxxxxxx  aie  as  follows: 


Field  Name 

Contents 

ATDTE 

Date  and  time  of  archival 

CLASS 

SYSOUT  class 

DEST 

SYSOUT  destination 

FORMS 

SYSOUT  forms  name 

ID 

SYSOUT  identification 

JID 

Subsystemjob  identifier 

JNAME 

Job  name 

WTR 

External  writer  name 

Continued 
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Continued 

Field  Name 

Contend 

XCODE 

Exceptioncode 

Ummmn 

User  accounting  data  supplied  by  either  the  SARACTUX 
or  SARSTCUX  user  exits  (up  to  20  characters  of  user  data) 

The  beginning  and  ending  positions  in  the  user  data  are 
specified  by  mm  and  nn,  respectively.  If  mm  is  omitted,  1  is 
assumed  for  the  beginning  position!  If  nn  is  omitted,  20  is 
assumed  for  the  ending  position.  If  nn  is  omitted,  the  colon 
can  also  be  omitted. 

NAME 


Syntax 


This  parameter  specifies  the  high-level  name  of  the  CA-View  database. 


llAIlE=ii2dax 


If  omitted,  the  high-level  name  specified  as  the  FARM  parameter  on  the  EXEG 
SARINTT  JCL  statement,  if  any,  is  used. 


NARCCLSL 


This  parameter  specifies  a  list  of  1  to  8  SYSOUT  classes  that  CA-View  will  not 
archive.  Any  SYSOUT  originally  output  to  one  of  the  classes  is  selected  and 
processed  by  CA-View  but  is  not  ardnived.  In  general,  the  classes  should  also  be 
specified  for  automatic  printing,  or  the  SYSOUT  will  be  deleted  by  CA-View. 

Syntax  narcclslsjdocxxxxx 

There  is  no  default. 


NBACKUP 


This  parameter  specifies  the  number  of  interim  backups  done  during  the  time 
specified  with  the  INTERVAL  initialization  parameter.  These  backups  do  not 
cause  the  generation  number  to  be  incremented.  The  backups  are  executed 
evenly  spaced  within  this  time. 


Syntax 


NBACKUP=Illin 


There  is  no  default. 

To  determine  the  time  spacing  between  interim  backups,  add  one  to  the 
NBACKUP  number  and  then  divide  that  number  mto  the  INTERVAL  number. 
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NEWCLSL 


Syntax 


NEWDEST 


Syntax 


NEWFORM 


Syntax 


This  parameter  specifies  a  list  of  1  to  8  SYSOUT  classes  used  by  CA-View  to  print 
archived  SYSOUT,  both  online  and  in  batch. 

ilEWCLSL=xxxxxxxx 

The  classes  in  the  list  correspond  to  those  specified  by  the  CLSL  parameter.  The 
default  is  the  original  class.  For  example,  if  CLSL=AB  and  NEWCLSL=CD  are 
specified  as  parameters,  any  class  A  SYSOUT  is  printed  by  CA-Vie'w  as  class  C, 
and  any  class  B  SYSOUT  is  printed  by  CA-View  as  class  D.  If  no  corresponding 
class  is  specified  by  using  the  NEWCLSL  parameter,  CA-View  prints  SYSOUT 
using  the  original  class  tmder  which  it  was  created. 

Note:  The  TSOCLS  parameter  (online  printing  from  TSO)  and  the  JCLASS 
parameter  (batch  printing),, if  specified,  override  this  parameter. 


This  parameter  specifies  the  destination  used  by  CA-View  to  print  archived 
SYSOUT.  If  NEWDEST  is  not  specified,  CA-View  prints  SYSOUT  using  the 
original  destination  under  which  it  was  created. 

There  is  no  default: 

Note  that  the  TSODEST  parameter,  if  specified,  overrides  the  parameter  for 
online  retrieval  printing. 


This  parameter  specifies  the  forms  name  used  by  CA-View  to  print  archived 
SYSOUT.  If  NEWFORM  is  not  specified,  CA-View  prints  SYSOUT  using  the 
original  forms  name  under  which  it  was  created. 


NEWFORHsjaoac 


There  is  no  default 

Note  that  the  TSOFORM  parameter,  if  specified,  overrides  this  parameter  for 
online  retrieval  printing. 
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NEWPASS 

Syntax 

NGEND 

Syntax 

NGENI 

Syntax 

NGENT 

Syntax 


This  parameter  specifies  whether  a  new  password  must  be  entered  twice  to  verify 
its  accuracy. 

NEWPASS=VER1PY | NOVERIFY 


The  default  is  NOVERIFY. 


This  parameter  specifies  the  number  of  generations  maintained  on  disk. 
lI6EIID=min 

The  default  is  3. 

The  smallest  allowable  value  is  NGEND=1,  which  keeps  only  the  current  archival 
generation  on  disk. 


This  parameter  specifies  the  number  of  master  indexes  maintained  on  storage 
group  0.  All  storage  group  0  tapes  containing  generations  within  the  last  NGENI 
generations  are  kept.  Other  storage  group  tapes  are  kept  only  if  they  contain 
reports  that  are  kept. 

NGENI  =zzzin 

The  default  is  the  value  of  NGENT. 


This  parameter  specifies  the  number  of  total  generations  to  be  maintained  on 
tape. 

NGENT  =iuin 

The  default  is  90. 
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PAGEMARK 


Syntax 


PRTALL 


Syntax 


PRTASA 


Syntax 


PRTCLSL 


Syntax 


This  parameter  specifies  whether  pages  are  identified  and  numbered  when 
archived. 


The  default  is  YES. 


This  parameter  specifies,  for  the  EXPO  mode  of  CA-View,  an  initial  default  value 
used  in  CA-Deliver  reprints.  PRTALL  determines  whether  the  distribution 
identifier's  OUT  indicator  is  used  during  a  reprint. 


PRTALL=yES I  NO 

YES  Specifies  that  the  distribution  identifier's  OUT  indicator  is 
ignored 

NO  Specifies  that  ttie  distribution  identifier's  OUT  indicator  is  used 

The  default  is  YES. 


This  parameter  specifies  whether  CA-View  reprints  should  be  in  ASA  or  machine 
control  characters. 

PRTASA=YES I  NO 

The  default  is  NO. 


This  parameter  specifies  a  list  of  1  to  8  SYSOUT  classes,  so  that  any  SYSOUT 
originally  output  to  one  of  the  classes  is  automatically  printed  by  CA-View  when 
it  is  archived.  See  the  CLSL  initialization  parameter. 

VRTCLSh^XXXXXXXX 

There  is  no  default. 
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PWBATCH 


Syntax 


RACF 


Syntax 


RCVPRIM 


Syntax 


Refer  to  the  section  on  Printing  SYSOUT  in  Qxapter  9,  "Batch  Processing,"  for 
more  information. 


Note:  For  this  initialization  parameter  to  work  properly,  the  JES2  initialization 
statement  STCCLASS  must  specify  OUTPUT=YES. 


This  parameter  specifies  a  password  used  to  verify  that  a  background  job  to 
retrieve  a  SYSOUT  group  was  submitted  by  onhne  retrieval. 

pnB&TCB=xxxxxxx»; 

There  is  no  default 

The  password  is  placed  on  the  control  card  by  online  retrieval  and  cheeked  by  the 
batch  retrieval  program.  If  the  passwords  match,  retrieval  is  allowed.  If  the 
passwords  do  not  match  or  no  password  has  been  defined,  the  security  user  exit 
is  invoked  or  RACF  checking  is  done  to  determine  authorization. 

PWBATCH  is  used  to  eliminate  the  overhead  involved  in  performing  security 
checking  both  online  and  then  a  second  time  in  batch. 


This  parameter  specifies  whether  RACF  checking  is  done  by  CA-View  when 
retrieving  individual  SYSOUT  groups  and  supplies  the  high-level  index  and 
volume  serial  number  to  be  used  to  define  the  SYSOUT  group  to  RACF. 


RACF=XXXX2CX 


There  is  no  default. 

This  parameter  must  not  be  specified  with  the  CA-ACF2  parameter,  because  the 
two  parameters  are  mutually  exclusive. 


This  parameter  specifies  the  primary  space  allocation  for  the  forward  recovery 
data  sets.  This  is  required  for  forward  recovery  to  be  activated. 

RCVFRXH^xxxx 

There  is  no  default. 
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RCVSEC 


This  parameter  specific  the  secondary  space  allocation  for  the  forward  recovery 
data  sets.  This  optional  parameter  is  used  when  the  primary  space  allocation  is 
exhausted. 


Syntax 


RGVSEC  =3aacx 


There  is  no  default. 


RCVSPACE 


This  parameter  specifies  whether  the  space  allocation  for  the  forward  recovery 
data  sets  is  to  be  obtained  in  tracks  (TRiCS)  or  cylinders  (CYLS). 

Syntax  rgvspxge=trks  |  cyls 

The  default  is  TRKS. 

This  parameter  is  optional. 


RCVUNIT 


This  parameter  specifies  tiie  unit  name  or  unit  type  where  the  forward  recovery 
data  sets  are  to  be  allocated.  This  is  required  for  forward  recovery  to  be  activated. 


Syntax 


RCVTJHIT=unit 


There  is  no  default. 


REDISP 

This  parameter  specifies  whether  the  ENTER  key  will  invoke  the  REDISP 
function,  which  causes  a  refresh/update  of  SYSOUT  and  report  selection  lists. 

Syntax  redisp=yes  |  no 


The  default  is  NO. 


RETPD 


This  parameter  specifies  the  number  of  days  maintained  on  tape  (mutually 
exclusive  with  EXPDT).  This  is  the  retention  period  for  allocating  a  new  tape  data 
set.  The  most  recently-entered  option  (RETPD  or  EXPDT)  takes  precedence. 
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Syntax 


ROUT 


Syntax 


ROUTBKP 


Syntax 


SELPNLS 


Syntax 


SETPAGE 


BETPDBmui 

There  is  no  default. 


This  parameter  specifies  the  route  code  to  be  used  for  routing  exceptional 
condition  messages  (message  ID  SARSTC99).  The  text  for  the  exceptional 
condition  message  is  extracted  during  the  exceptional  condition  checking  process 
or  produced  by  the  SARSTCUX  user  exit. 


R001P=mi 


The  default  is  0. 

Specify  a  route  code  of  to  16  for  the  WTO  that  issues  the  messages.  A  route  code 
of  0  suppresses  the  messages. 


This  parameter  specifies  a  route  code  for  the  informational  CA-View  backup 
messages  SARBKT61  through  SARBKT63. 

ROUTBKP =an 

The  default  is  ROUTBKP=l. 


The  default  value  sends  the  messages  to  the  master  console. 


This  parameter  specifies  the  number  of  selection  panels  to  be  used  in  the 
left/right  scrolling  selection  lists. 

SELPNLS=:jin 

The  default  is  5. 


This  parameter  specifies  either  YES  or  NO  as  to  whether  to  set  PRMODE  to 
PAGE  when  PAGEDEF  and/or  FORMDEF  are  specified. 


Initialization  Parameters  2-27 


Initialization  Parameter  Descriptions 


Syntax 


SMF 


Syntax 


STACKBU 


Syntax 


START 


SETPA6E=YES | NO 

The  default  is  YES. 

Values  are  as  follows: 

YES  Sets  PRMODE  to  PAGE  when  PAGEDEF  and/or 

FORMDEF  are  specified 

NO  '  Leaves  PRMODE  as  is 


This  parameter  specifies  whether  the  archival  task  is  to  create  special  type-6  SMF 
records  when  it  prints  a  SYSOTJT  group. 


shf=yes|no 


The  default  is  NO: 


This  parameter  specifies  whether  stacked  backup  cycles  should  be  processed 
normally  or  ignored.  Stacked  backup  cycles  occur  when  the  archival  task 
becomes  suspended  diuing  a  backup  cycle  (before  the  cycle  is  completed)  due  to 
the  initiation  of  a  second  backup  cycle.  This  condition  is  indicated  with  the 
SARBKU03  message. 

STACKBU=^S  I  NO 

The  default  is  NO. 

Values  are  as  follows: 

YES  Processes  stacked  backup  cycles 

NO  Ignores  stacked  backup  cycles 


This  parameter  specifies  the  name  of  the  microfiche  start  procedure  that  is  started 
after  the  currentarchival  generation  is  completed  and  backed  up  to  tape. 
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Syntax 


STORGRPO 


Syntax 


STKRT=jat3aaaaac 


The  default  is  no  procedure. 


This  parameter  specifies  the  default  tape  storage  group.  With  ERO  (Expanded 
Retention  Option),.you  can  define  up  to  nine  additional  tape  storage  groups.  See 
STORGRPlto  STORGRP9  later  in  this  chapter. 

You  must  run  a  standard  or  interim  backup  cycle  to  assign  reports  to  tape  storage 
groups  specifying  appropriate  storage  group  subparameters. 

STORGSP  0  =8 torage -group-name /tape  - index/ 

maxgent -value /unit  1 -name, unit2-name/ tvserl,  tvaer2 

where: 

storage-group-name  Not  considered  for  STORGRPO,  the  default  storage 

group 

If  you  define  any  additional  storage  groups 
(STORGRPl  to  STORGRP9),  you  must  assign  each  one  a 
group-name  of  up  to  eight  alpha-numeric  characters. 
The  name  DEFAULT  is  reserved  for  use  by  the 
SARPAG  tape  consolidation  program,  and  therefore 
cannot  be  specified. 

Reports  are  assigned  to  tape  storage  groups  by  the  ERO 
table  statement  STOKGRP=storage-group-name. 

tape-index  Specifies  an  alternate  naming  prefix  (up  to  17 

characters)  for  your  backup  tapes 

If  this  parameter  is  changed,  tapes  previously  produced 
by  GA-View  wiU  still  be  accessible.  If  omitted,  the  high- 
level  name  of  the  database  is  used. 

There  is  no  default. 

maxgent-value  Specifies  the  maximum  number  of  generations  that  can 

be  written  to  one  tape  voliome 

The  default  is  IG. 
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unitl-mme,  unit2-name  unitl  Specifies  the  tape  -unit  name  allocated  for  backup 

tape  archival  generations 

unitl  Activates  tape  duplexing,  and  specifies  its  tape 
unit  name 

When  duplexing  is  activated,  two  tapes  are  mormted 
during  the  backup  cycle.  The  first  tape  is  for  the 
primary  backup  tape,  and  the  second  tape  is  for  the 
duplex  tape. 

The  default  is  TAPE. 

When  retrieving  output  from  tape,  CA-View  always 
uses  the  primary  backup  tape.  Should  an  error  occur  on 
the  primary  backup  tape  and  a  duplex  of  it  exists, 
CA-View  automatically  attempts  to  recover  from  the 
error  by  switching  to  the  duplex  tape. 

tvserl,tvser2  Specifies  a  range  of  tape  volume  serial  numbers  used  for 

the  backup  archival  generations 

The  default  is  any  scratch  tape. 

Volume  serial  mnnbers  must  be  the  same  length,  end 
with  1  or  more  numeric  digits,  and  have  matching 
beginning  alphanumeric  characters.  Whenever  a  new 
tape  is  required  to  back  up  a  generation,  the  next  tape  in 
the  range  is  used.  When  the  end  of  the  range  is  reached, 
the  first  tape  in  the  range  is  used. 

Two  different  tape  storage  groups  can  specify  the  exact  same  range  of  tapes,  or 
completely  distinct  ranges,  but  no  partial  overlap  is  allowed  between  groups. 


STORGRXO 


This  parameter  specifies  additional  attributes  (extensions)  for  the  tape  storage 
groups.  If  you  use  tape  duplexing,  you  can  specify  a  volume  serial  range  for  the 
duplex  tapes  here.  If  you  use  tape  duplexing,  (indicated  by  the  unit2-name  in  the 
STORGRP  parameter),  and  the  STORGRX  parameter  is  specified  without  any 
values  for  dtvserl  and  dtvserZ,  a  scratch  pool  will  be  used  for  the  duplex 
volumes. 

If  the  database  is  versioned  up  from  a  release  prior  to  1.7,  the  initial  values  for 
dtvserl  and  dtvser2  will  be  the  same  as  for  tvserl  and  tvser2  (the  primary  range). 
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Syntax 


STOR6KXO=dtV£rerl>  dtv3Br2  j  saeblks 
where: 

dtversl,  dtvserl  Specifies  a  range  of  tape  volume  serial  numbers  used  for  the 
duplex  backup  archival  generations 

The  default  is  any  scratch  tape. 

Volume  serial  numbers  must  be  the  same  length,  end  with  one 
or  more  numeric  digits,  and  have  matching  beginning 
alphanumeric  characters.  Whenever  a  new  tape  is  required  to 
back  up  a  generation,  the  next  tape  in  the  range  is  used.  Whem 
the  end  of  the  range  is  reached,  the  first  tape  in  the  range  is 
used. 

mxblks  Specifies  the  maximum  number  of  storage  blocks  to  which  to 

write  the  primary  and  duplex  volumes  (the  primary  and 
duplex  volumes  are  mirror  images) 

A  value  of  0  means  to  write  to  end-of-volume. 

Two  different  tape  storage  groups  can  specify  the  exact  same  range  of  tapes,  or 
completely  distinct  ranges,  but  no  partial  overlap  is  allowed  between  groups. 


TAPEOPT 


This  parameter  specifies  the  options  for  tape  processing. 

Syntax  TAPEOPT=3420 | 3480 |EAST,HaRDjNOKU\RD,SGFT|NOSOFT 

The  default  is  3480,HARD,NOSOFT. 

Values  are  as  follows: 

3420 1 3480  i  EAST  Specifies  whether  archival  tapes  are  written  using  3480 
(includes  3490)  data  block  location  processing,  or  3420 
processing 

3480  tape  processing  has  superior  performance  to  3420 
tape  processing,  but  requires  3480  or  3490  tape  drives. 

3480/3490  tape  processing  is  a  requirement  for  the 
expanded  access  server  for  tape  and  robotics.  EAST  is  the 
same  as  3480  tape  processing;  however,  the  Expanded 
Access  Server  for  Tape/Robotics  will  be  used,  whenever 
possible,  to  access  reports  from  tape. 

w 
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TAPECLSL 


Syntax 


TAPESEQ 


Syntax 


HARD  I NOHARD'  Specifies  whether  the  hardware  compaction  feature  is  to 
be  used  for  compacting  data  for  a  tape  device  enabled  for 
hardware  compaction 

HARD  specifies  that  the  hardware  compaction  feature  is 
to  be  us^,  and  NOHARD  specifies  that  the  hardware 
compaction  feature  is  not  to  be  used^  If  you  use  3490E  tape 
drives,  you  must  specify  HARD: 

SOFT  i  NOSOFT  Specifies  whether  CA-View  is  to  compress  data  when 
creating  backup  tapes 

SOFT  specifies  that  software  compression  is  to  be  used, 
and  NOSOFT  specifies  that  software  compression  is  not  to 
be  used. 


This  parameter  specifies  a  list  of  1  to  8  SYSOUT  classes,  so  that  any  SYSOUT 
originally  output  to  one  of  the  classes  is  directly  archived  to  tape,  and  no  archival 
is  done  to  disk.  If  any  class  is  specified  for  TAPEGLSIL,  a  tape  drive  is  allocated 
for  the  duration  of  the  archival  task. 

TAFECLSIisxxxxxxxx 

There  is  no  default 

Note:  This  parameter  is  a  secondary  criterion — that  is,  output  must  first  satisfy 
the  primary  criteria  of  GLSL,  DEST,  and  FORM  before  it  is  considered  for 
application  of  this  parameter. 


This  parameter  specifies  the  starting  tape  sequence  number  estabUshed  in  a  new 
database. 

TAPES&Q=aiinn 

The  default  is  1. 


Warningl  paidmotci  JS  lubt  noJihed  onlj  at  thi  ihm  tioii  i  a 
Lompuler  \'-sociates  Tec.lmn.til  ‘^iippi'rt  n.prt  s(»filtiti\  t. 
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TBACKUP 

Syntax 


TIME 

Syntax 

TP054 


This  parameter  specifies  backup  options. 

TBAG)EnjP=YES  |  NO  |  ZDX 
The  default  is  YES. 

Values  are  as  follows: 

YES  Both  the  SYSOUT  groups  archived  to  the  current  disk  generation  and 
the  master  index  are  written  to  tape  as  part  of  the  backup  cycle 

NO  Neither  the  SYSOUT  groups  archived  to  the  current  disk  generation 
nor  the  master  index  is  written  to  tape  as  part  of  the  backup  cycle 

IDX  Only  the  master  index  is  written  to  tape  as  part  of  the  backup  cycle 


Warning!  Spei.if' I  ith«  1  \0  oi  IPX  foi  tin  Tb  \Ckl  I  J  aiamt  tt.'  in 
prevent  future  I ot  data  it  tin  rt  is  a  nu  dn  f  iiluit.  ot  ot  tu  t\pt  ol 


This  parameter  specifies  the  time  at  which  the  first  backup  cycle  is  automatically 
initiated  by  CA-View. 

The  default  is  0. 

The  value  is  based  on  a  24-hour  clock,  where  hh  is  the  hour,  and  mm  is  the 
minute.  Subsequent  backup  cycles  are  automatically  initiated  at  regular  intervals 
specified  with  the  INTERVAL  parameter.  Automatic  backup  cycles  are 
suppressed  on  those  days  identified  by  an  N  in  the  DAYS  parameter.  The  default 
value  (0)  suppresses  all  automatic  backup  cycles. 


This  parameter  specifies  whether  message  SARTP054  (TAPE  TO  BE  MOUNTED 
NEEDS  FILE  PROTECT  RING  IN)  is  to  be  displayed  for  the  remounting  of 
archival  tapes. 
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Syntax 


TSOCLS 


Syntax 


TSODEST 


Syntax 


TSOFORM 


Syntax 


TP054=YES|N0 


The  default  is  YES. 


This  parameter  specifies  the  SYSOUT  class  to  appear  on  the  Print  Attribute  panel 
when  a  SYSOUT  is  printed  with  the  online  P  selection  code  from  the  TSO  online 
retrieval  facility. 

TSOCLS  =3e 

The  default  is  NEWCLS/originali 


Specify  an  asterisk  (TSOCLS=*)  to  have  the  TSO  online  retrieval  session  class 
used  as  the  CLASS.  The  default  is  the  NEWGLSL  initialization  parameter,  and,  if 
NEWCLSL  is  not  specified,  the  CLSL  from  the  original  SYSOUT  job. 


This  parameter  specifies  a  valid  SYSOUT  destination  used  to  print  SYSOUT  with 
the  TSO  online  retrieval  feature.  Specify  an  asterisk  to  use  the  system  default 
SYSOUT  destination. 

TSODEST=3aaaaaacx 

The  default  is  origmal/NEWDEST. 


This  parameter  specifies  a  SYSOUT  forms  name  used  to  print  SYSOUT  with  the 
online  retrieval  feature. 

TSOFORH=xxxx 

The  default  is  the  original/NEWFORM  forms  name. 

Specify  an  asterisk  to  use  the  system  default  forms  name  for  the  online  session. 
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TSOSCHED 

Syntax 


UNITSPEC 

Syntax 

UNLOAD 

Syntax 


This  parameter  schedules  background  SYSOUT  retrieval 

TSOSCHED=SUBHXT | INTRDR 

The  default  is  SUBMIT. 

Values  are  as  follows; 

SUBMIT  Uses  the  TSO  SUBMIT  command  processor  to  schedule 
background  SYSOUT  retrieval  from  a  foregrotmd  session 

INTRDR  Directly  allocates  an  internal  reader  to  schedule  background 
SYSOUT  retrieval  from  a  foreground  session 

This  parameter  is  used  for  the  ISPF  and  TSO  online  interfaces,  not  the 
ISPF/ cross-memory  or  TSO/cross-memory  interface. 


This  parameter  is  used  if  there  is  the  possibility  of  a  conflict  of  units  during 
dynamic  allocation  of  backup  media.  CA-View  uses  the  MVS  catalog  device 
types  to  allbcate  backup  media.  If  necessary,  use  this  parameter  to  specify  the 
esoteric  names  of  up  to  two  backup  media  units  (tape,  optical,  etc.)  which  have 
the  same  device  type  as  other  devices  in  the  system. 

UNITSPEC=unitI, unit2 
There  is  no  default. 

For  example,  if  you  have  a  pool  of  3480-type  tape  drives,  and  a  pool  of  3480-type 
optical  drives,  you  could  specify: 

UHITSPEC=optziaine 

where  aptmme  is  the  esoteric  name  of  the  optical  drives. 


This  parameter  identifies  whether  the  tape  will  be  unloaded  and  the  drive  freed 
during  direct-to-tape  archival. 

Uin.OAD=lIO  I  YES  I  NOWORK 

The  default  is  NO. 
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USERLVL 


Syntax 


VPRTAPPL 


Syntax 


VPRTMAXO 


Syntax 


Values  are  as  follows: 

YES  Specifies  tounlOad  the  tape  after  the  SYSOUT  group  is  archived 

direct-to-tape 

NO  Specifies  to  leave  the  tape  mounted  after  the  SYSOUT  group  is 

archived  direct-to-tape 

NOWORK  Specifies  that  the  tape  is  to  remain  moimted  until  there  are  no 
more  SYSOUT  groups  to  be  direct-to^tape  archived,  even  if  the 
remaining  groups  are  going  to  disk 


This  parameter  determines  whether  users  will  get  the  Beginning  or  Advanced 
Primary  Selection  Menu  in  the  online  modes  EXP  and  E)Q?0.  This  parameter 
affects  only  the  Primary  Selection  Menu. 

USERl.VL=BE6IiniER  I  ADVANCED 

The  default  is  BEGINNER. 


This  parameter  specifies  the  first  four  characters  of  the  VTAM  APPLIDs  to  be 
used  by  the  CA-View  VTAM  Print  Option  (VPO).  These  characters  are  coupled 
with  a  number,  from  000  to  9999,  to  form  the  actual  VTAM  APPLID. 

VPRTAPPL  =cacc 

Note:  A  value  for  this  number  (if  provided  in  the  application  program  definition 
tables,  usually  located  in  SYSl.VTAMLST)  is  used. 


This  parameter  specifies  the  maximum  number  of  lines  that  can  be  printed  from 
an  online  session  by  using  the  P  print  selection  code  and  is  used  by  the  CA-View 
VTAM  Print  Option  (VPO). 


VPRTMAXO  =Z2X2zm 


The  minimum  value  is  1;  the  maximum  value  is  65535. 
The  default  is  UNLIMITED. 
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VPRTONL 


Syntax 


VPRTPRINT 


Syntax 


VPRTRTRY 


Syntax 


This  parameter  specifies  whether  users  can  print  from  an  online  session  using  the 
P  (print)  selection  code  used  by  the  CA-View  VTAM  Print  Option  (VPO). 

VPRTONL=YES | NO 

The  default  is  YES. 

Note:  The  user's  terminal  is  locked  for  the  duration  of  the  printing. 


This  parameter  specifies  the  interval  in  seconds  between  attempts  to  establish 
contact  with  a  printer  and  is  used  by  the  CA-View  VTAM  Print  Option  (VPO). 

VPRTRINT=nnn 

If  VPRTAPPL  is  specified  as  SARV,  and  SYSl.VTAMLST  contains  SARVOOOO- 
SARV0009,  CA-View  attempts  to  contact  the  designated  printer  using  SARVOOOl, 
SARV0002...SARV0009. 

The  minimum  value  is  1;  the  maximum  value  is  65535. 

The  default  is  60. 


This  parameter  specifies  the  number  of  times  CA-View  tries  to  re-establish 
contact  to  a  printer  and  is  used  by  the  CA-View  VTAM  Print  Option  (VPO). 

VPRTRTRY  =n2ia 

If  VPRTAPPL  is  specified  as  SARV,  and  SYSl.VTAMLST  contains  SARVOOOl- 
SARV0009,  CA-View  attempts  to  contact  the  designated  printer  using  SARVOOOl, 
then  SARV0002,...SARV0009.  The  minimum  value  is  1;  the  maximum  value  is 
255. 

The  default  is  10. 
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WAIT 

This  parameter  specifies  whether  the  archival  task  waits  for  SYSOUT  to  archive 
or  terminates,  when  there  is  no  more  SYSOUT  available  from  JES. 

Syntax  wait=yes|no 

The  default  is  YES. 

Most  sites  use  the  default  value. 

XPRINT 

This  parameter  specifies  whether  CA-View  automatically  prints  any  SYSOUT  in 
which  an  exceptionali  condition  occurs.  Exceptional  conditions  are  determined 
dining  the  exceptional  condition  checking  process  or  are  determined  by  user 
code  in  the  SARSTCUX  user  exit. 

Syntax  xPRiNT='!rEs|NO 

The  default  is  YES. 


Expanded  Retention  Initialization  Parameters 

The  expanded  retention  initialization  parameter  statements  follow  the  same 
syntax  and  restrictions  as  flie  initialization  parameter  statements.  Several  of  these 
initialization  parameters  work  in  conjunction  with  parameters  specified  in  the 
Expanded  Retention  table.  See  Appendix  A  for  details. 

The  Expanded  Retention  Option  must  be  installed  and  operational  to  use  the 
following  parameter  statements. 


DSK2DAYS 


This  parameter  is  used  by  secondary  storage  device  drivers  such  as  optical  disks. 
This  parameter  is  documented  in  Chapter  10,  "Using  the  Optical  Disk  Interface." 

Syntax  DSK2DAYs=iiJin 

The  default  is  999. 


2-38  CA-View  System  Reference  Guide 


Expanded  Retention  Initialization  Parameters 


DSK2DRVR 


Syntax 


DSK2INTV 


Syntax 


DSK2MIGD 


Syntax 


DSK2PARM 


Syntax 


DSK2TIME 


Syntax 


This  parameter  is  used  by  secondary  storage  device  drivers  such  as  optical  disks. 
This  parameter  is  documented  in  Chapter  10,  "Using  the  Optical  Disk  Interface." 

DSK2DRVR=driver 
There  is  no  default. 


This  parameter  is  used  by  secondary  storage  device  drivers  such  as  optical  disks. 
This  parameter  is  documented  in  Chapter  10,  "Using  the  Optical  Disk  Interface." 

DSK21KITV=xmzixt 
There  is  no  default. 


This  parameter  is  used  by  secondary  storage  device  drivers  such  as  optical  disks. 
This  parameter  is  documented  in  Chapter  10,  "Using  the  Optical  Disk  Interface." 

DSK2Hr6D=x»acxxx 
The  default  is  BBBBBBB. 


This  parameter  is  used  by  secondary  storage  device  drivers  such  as  optical  disks. 
This  parameter  is  documented  in  Chapter  10,  "Using  the  Optical  Disk  Interface." 

DSK2FABM=jexxxxxxxxx 
There  is  no  default. 


This  parameter  is  used  by  secondary  storage  device  drivers  such  as  optical  disks. 
This  parameter  is  documented  in  Chapter  10,  "Using  the  Optical  Disk  Interface." 


DSK2TIME=nnnn-iiniin^«iirLa-nmm,nnnn-nnnn/r2nnn-nnnn 


There  is  no  default. 
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DSK2XXX 


EROOPT 


Syntax 


EROPRO 


Syntax 


Refer  to  Chapter  IG,  "Using  the  Optical  Disk  Interface/'  for  information  about  the 
optical  disk  parameters. 


This  parameter  specifies  whether  the  Expanded  Retention  Option  is  being  used. 
Indicate  YES  to  retain  expanded  retention  initialization  parameters,  or  NO  to 
delete  reference  to  all  expanded  retention  initialization  parameters. 

EROOPT=YES |N0 

For  an  existing  CA-View  database,  EROOPT  defaults  to  YES  if  Expanded 
Retention  Initialization  Parameters  exist  or  new  expanded  retention  initialization 
parameters  are  being  set;  otherwise,  this  parameter  defaults  to  NO^ 

For  a  new  CA-View  database,  EROOPT  defaults  to  YES  if  expanded  retention 
initialization  parameters  are  specified;  otherwise,  this  parameter  defaults  to  NO: 


This  parameter  specifies  whether  all  archived  SYSOUTs,  or  only  newly-archived 
SYSOUTs,  will  be  considered  for  expanded  retention.  This  allows  you  to  make 
the  ERO  table  retroactive — ^that  is,  to  request  that  CA-View  consider  every 
archived  SYSOUT  for  expanded  retention,  not  just  newly  archived  SYSOUTs. 

EROFROsNEW  I  ALIi  |  'ZES 
The  default  is  NEW. 

Values  are  as  follows: 

NEW  Recommended  for  better  performance 

YES  Specifies  that  ALL  SYSOUT s  are  considered,  and  the  parameter  is  not 

reset  to  NEW  at  the  end  of  the  backup  cycle 

ALL  A  one-time  request  to  Reset  to  reconsider  the  entire  database 

This  is  reset  to  NEW  at  the  end  of  the  backup  cycle. 
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o 


PCOPIES 

This  parameter  specifies  the  number  of  copies  of  each  SYSOUT  that  are 
maintained  for  each  unique  SYSOUT  identifier. 

Syntax  pcopiES=jexx 

The  default  is  2. 


PMXTAPES 

This  parameter  specifies  the  maximum  number  of  tapes  that  can  be  consolidated 
in  any  one  execution  of  the  SARPAC  tape  consolidation  program. 

Syntax  PMXTAPES=nnnnn 

The  defaxilt  is  20. 


PMXYEARS 

i  This  parameter  specifies  the  maximum  number  of  years  data  can  reside  on  a  tape 

— ''  and  is  used  by  the  SARPAG  tape  consolidation  program.  When  the  creation  date 

for  the  tape  exceeds  this  value,  the  tape  is  selected  for  consolidation. 

Syntax  PMXYE!ARS=nnnnn 

The  default  is  3. 

Specifying  a  maximiim  number  of  years  is  important,  because  tapes  tend  to  have 
I/O  problems  as  they  age. 

POPT 

This  parameter  specifies  how  SYSOUT  is  to  be  given  expanded  retention. 

Syntax  •  popt=m|l|a 

The  default  is  M. 


o 


Initialization  Parameters  2-41 


Expanded  Retention  Initialization  Parameters 


PRETAIN 


Syntax 


PTEXTl  to  PTEXT5 


Syntax 


Values  are  as  follows: 

M  Specifies  that  only  SYSOUT  marked  from  the  online  or  batch  facility  is 

given  expanded  retention 

L  Specifies  that  the  last  (most  recent)  SYSOUT  for  each  unique  SYSOUT 
identifier  in  the  current  generation  is  given  expanded  retention 

If  you  specify  L,  and  SYSOUT  for  a  SYSOUT  identifier  is  marked  online 
for  expanded  retention,  the  marked  SYSOUT  is  given  expanded 
retention  instead  of  the  last  (most  recent)  SYSOUT. 

A  Specifies  that  all  SYSOUT  from  the  current  generation  is  given  expanded 
retention 


This  parameter  specifies  the  expiration  parameters  of  ERO  (Expanded  Retention 
Option)  reports. 

PR£TAIH=II1ZT  I  TABLE 

The  default  is  INIT. 

Retention  is  as  follows:  'y  _  J 

PRETAIN=TABIlE  Ignores  EMIT  parms  and  uses  ERO  table  only 
PRETAIN=INIT  Uses  the  EMIT  parms 

We  recommend  that  you  set  PRETAEM=TABLE;  this  makes  the  ERO  table 
statements  the  single  point  of  control  for  the  retention  of  ERO  reports.  With 
PRETAIN=TABLE,  when  a  report  has  satisfied  the  ERO  table  statement  that 
controls  it,  it  is  deleted. 


This  parameter  specifies  unique  text  used  for  scanning  archival  data  to  locate  the 
SYSOUT  identifier  used  to  name  the  SYSOUT  group.  See  Chapter  6,  "Expanded 
Retention  Option,"  for  more  details. 

PTEXT1=XXXXXXX3£XX 
PTEXT2  =xx»3cxxxxxx 
PTEXT3  =3exx3cx3cxxxx 
PTEXT4  =3aaaac3aac3cx 
PTEXT5  =3C3aaaciaatxx 

There  is  no  default. 
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PTHRESH 

This  parameter  specifies  the  percentage  of  active  SYSOUT  groups  on  a  tape  as  a 
threshold  value  and  is  used  by  the  SARPAG  tape  consolidation  program  to 
determine  whether  to  consolidate  a  tape.  When  the  percentage  of  active  SYSOUT 
groups  on  a  tape  is  less  than  this  threshold  value^  the  tape  is  selected  for 
consolidation. 

Syntax  PTHRESH=nniinn 

The  default  is  50. 


PXCOND 

This  parameter  specifies  whether  exceptional  conditions  are  included  in  the 
expanded  retention  process. 

Syntax  pxcoijd=yes|no 

The  default  is  YES. 


STORGRPl  to  STORGRP9 

STORGKPl  through  STORGRP9  allow  you  to  define  up  to  nine  tape  storage 
groups  in  addition  to  the  default  group,  STORGRPO.  See  the  description  of 
STORGRPO  earlier  in  this  chapter. 

Creating  STORGW?!  through  STORGRP9  in  addition  to  the  default,  STORGRPO, 
allows  you  to  do  the  following: 

■  Separate  reports  into  groups  by  how  often  they  are  viewed 

This  orgaiuzation  can  be  used  to  maximize  performance  of  the  Expanded 
Access  Server,  which  allows  you  to  view  from  tape  without  loading  to  disk. 

■  Separate  reports  into  groups  by  their  retention  requirements 
This  organization  lessens  the  need  for  tape  consolidation. 

■  Use  tape  duplexing  on  some  reports,  not  on  others 

■  Use  an  alternate  high-level  index  for  certain  tapes 

■  Use  a  different  number  of  generations  written  to  different  tapes 

■  Use  separate  ranges  of  tape  volumes  used  for  the  backup  tapes 

New  storage  groups  inherit  their  initial  values  from  STORGRPO  for  parameters 
that  are  not  specified. 
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To  delete  a  storage  group,  specify  it  without  parameters.  For  example: 

STORGRF3= 

deletes  STORGRFS. 

The  STORG'BF^group-mme  ERO  table  parameter  assigns  reports  to  storage 
groups.  See  Tape  Eocation:  STORGRP  in  Chapter  6,  "Expanded  Retention 
Option/' 

If  you  define  tape  storage  groups,  you  should  assign  the  group  containing  the 
most  reports  as  STORGRPl  to  enhance  backup  cycle  performance. 


STORGRXl  to  STORGRX9 


STORGRXl  through  STORGRX9  allow  you  to  define  up  to  nine  tape  storage 
group  EXTENSIONS.. See  the  STORGRXO  command  earlier  in  this  chapter. 

To  delete  a  storage  group  extension,  specify  it  without  parameters.  For  example: 

STOR6RX3= 

deletes  STORGRX3. 

The  STORGRP=group-name  ERO  table  parameter  assigns  reports  to  storage 
groups.  (See  Tape  Location:  STORGRP  in  Chapter  6,  "Expanded  Retention 
Option/') 


Storage  group  extension  STORGRXn  is  valid  only  if  the  corresponding 
STORGRPm  parameter  is  defined. 


Initialization  Parameter  Examples 

The  following  sample  jobs  process  initialization  parameters. 

Example  1  A  new  database  has  its  initialization  parameters  set  for  an  archival  and  retrieval 

system  with  the  following  characteristics: 

■  ■  The  database  has  been  created  with  the  SARDBASE  utility  under  the  name 
VIEW.SYSTEMl. 

■  For  classes  P  and  Q,  alliSYSOUT  is  archived. 

■  Archival  is  to  disk,  and  the  backup  cycle  is  automatically  initiated  every  day 
except  Simday. 

■  The  expiration  date  for  tapes  is  99000. 

■  5  generations  can  be  backed  up  to  the  same  tape. 
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Example  2 


■  All  SYSOUT  (both  classes  P  and  Q)  is  printed  as  class  A. 

■  4  generations  are  maintained  on  disk. 

■  100  generations  are  maintained  on  tape. 

■  Exceptional  condition  messages  are  assigned  routing  code  14. 

■  The  backup  cycle  is  initiated  at  5:00  P.M. 

■  The  SYSOUT  is  automatically  printed  if  an  exceptional  condition  occurs. 

■  Scratch  tapes  are  used. 

■  Defaults  are  used  for  everything  else. 


The  following  job  is  run  to  set  the  initialization  parameters: 


//EXAMPLE!  JOB  ACCOUMT,PROGRAMMEB. 
//INIT  EXEC  PGM=SARINIT 

//STEPLIB  DD  DSKr=CA.X.GA!L!B,DXSP=SHR 
//SYSPRXNT  DD  SYSOUT=* 

//SYSXN  DD  * 

I1AHE=VXEW  .  SYSTEM! 

CLSL=PQ 

DAYS=YYYYYYN 

EXPDT=99000 


HAXGENT=5 

MEWCLSL=AA 

NGEMD=4 


H6EMT=!00 

ROUT=!4 


TXME=!700 

XPRIHTbYES 

// 


The  current  generation  of  SYSOUT  is  automatically  microfiched  by  start 
procedure  SARMFP  after  backup  to  tape.  The  SYSOUT  groups  are  sorted  as 
follows: 

■  Descending  order  by  user  accounting  data,  positions  11  to  20 

■  Descending  order  by  user  accounting  data,  positions  1  to  10 

■  Ascending  order  by  job  name 

■  Ascending  order  by  job  ID 


The  following  job  is  rim  to  modify  the  initialization  parameters: 


//EXAMPLE2  JOB  ACCOUMT, PROGRAMMER 
//XHXT  EXEC  PGM=SARXNXT 

//STEPLXB  DD  DSN=CAX .CAXLXB, DXSP=SHR 
//SYSPRXNT  DD  SYSOUT=* 

//SYSXN  DD  * 

NAME=VXEW . SYSTEM! 

MSGRT!=-U!!:20 

MSORT2=-U!:!0 

MSORT3=JNAME 

MSORT4=JXD 


START=SARMFP 

// 
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Example  3 


Expanded  retention  parameters  are  set  to  retaim  five  copies  of  all  marked 
SYSOUT  and  to  define  special  text  for  determining  SYSOUT  identifiers; 

//EXAHPIkES  JOB  ACCOUNT,  PKOGRAHUER 
//INIT  EXEC  PGM=SARINIT 

//STEPLIB  DD  DSH=CAZ.CAJZ.IB,DXSP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

NA11E=VIEW .  SYSTEHl 

POPT=M 

PCOPIES=5 

PTEXT1= 'PROGRAM-IDl ' 

PTBXT2 PROCEDURE ' . ' MAIN ' 

PTEXT3 = ' * * * ID= ' 

PTEXT4='SYSLMOD' . 'DSN=' . 'LIB( ' 

// 


Examples  An  existing  index  file  has  its  parameters  displayed: 

//EXAMPLES  JOB  ACCOUNT, PROGRAMMER 
//INIT  EXEC  PGM=SARINIT 

//STEPLIB  DD  DSN=CAI.CAILIB,DISP=SHR 
/ / SYSPRINT  DD  SYSOUT= * 

//SYSIN  DD  * 

HAHE=VIEW . SYSTEMl 

// 


I  i 
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In  This  Chapter 

This  chapter  details  the  configurable  components  of  CA-View,  and  includes  the 
following  topics: 

■  The  date  format  in  displays  and  reports 

■  Using  the  expanded  access  server  for  tape  and  robotics 

■  Optimizing  the  performance  of  the  expanded  access  server 

■  Job  accounting 

■  Microfiche  processing  with  SARMFP 

■  External  printing 

■  3800  printer  attributes 

■  The  recovery  data  set 

■  Security 

■  System  extensions  (SARXTD) 

Date  Format  in  Displays  and  Reports 

The  date  is  displayed  in  the  following  format  in  all  displays  and  batch  reports: 

UODDYY 

The  date  format  is  set  by  modifying  CA-View  with  the  IBM  AMASPZAP  utility. 
DDMMVYFormat  To  change  the  date  format  to: 

DDMOTY 

execute  the  following  job: 
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//DATEZAP 

//STEPl 

//SYSPRINT 


JOB  ACCOUNT, PROGRAMMER 
EXEC  PGH=AMASPZAP 
DD  SYSOUT=* 


//SYSLIB  DD  DSN=CA1.CAILIB,DISP=SHR 

//SYSIN  DD  * 

NAME  SARDFMT  SARDFMT 


VER  00  00 


REP  00  FF 


/* 


Change  the  data  set  name  on  the  SYSLIB  DD  statement  to  the  name  of  the  library 
containing  the  CA-View  load  modules. 


YYMMDD  Format  To  change  the  date  format  to: : 

YYMODD 


execute  the  job  shown  in  the  preceding  section,  changing  the  statement 

REP  00  FF 


to 

REP  00  FI 

Change  the  data  set  name  on  the  SYSLIB  DD  statement  to  the  name  of  the  library 
containing  the  CA-View  load  modules. 


Expanded  Access  Server  for  Tape  and  Robofics 

The  expanded  access  server  for  tape  and  robotics  allows  you  to  browse  a  report 
that  resides  only  on  tape,  without  having  to  load  the  report  back  to  disk. 

Using  the  server  instead  loading  back  to  disk  gives  you  the  following  benefits:: 

■  You  don't  need  to  wait  for  a  LOAD  batch  job,  which  will  have  to  wait  for  a 
tape  mount. 

■  You  don't  need  extra  DASD  space  in  the  disk  database  to  accommodate 
reports  temporarily  loaded  from  tape. 

The  printing  functions,  both  online  (P  command)  and  batch  (J  command),  and  the 
LOAD  from  tape  to  disk  function,  use  the  server,  and  benefit  from  centralized 
tape  mounts  and  caching. 

There  are  no  tape  drives  dedicated  to  the  tape  server.  The  server  is  allowed  to 
access  as  many  drives  as  you  specify.  Drives  are  automatically  freed  after  a 
specified  idle  time  (MAXIDLE). 
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Requirements 


You  must  be  using  3480  tape  processing.  The  initialization  parameter  TAPEOFT 
specifies  what  processing  CA-View  will  use  to  create  backup  tapes. 

The  expanded  access  server  is  not  available  imder  the  VM/CMS  online  interface 
or  CIGS  Conversational  online  interface  (GIGS  Pseudo-Conversational  is 
supported). 

Only  one  expanded  access  server  is  required  for  multiple  CA-View  databases. 


Internal  Operation 


The  server  receives  requ^ts  for  data  blocks  on  tape  to  be  printed  or  browsed. 
The  requested  data  blocks  are  handled  as  follows: 

■  If  the  data  blocks  are  already  cached  in  memory,  the  server  transfers  those 
blocks  via  cross  memory. 

■  If  the  data  blocks  are  already  in  memory,  the  server  reads  the  tape  if  it  is 
already  moimted,  or  moimts  the  tape. 

If  there  is  no  drive  available  to  the  server,  the  least  recently-referenced  tape, 
which  has  also  been  moimted  for  at  least  a  iiiiriimiun  amount  of  time  (MIMIDLE 
parameter)  is  dismoimted. 

If  a  tape  has  been  idle  for  a  maximum  amount  of  time  (MAXIDLE  parameter),  it 
will  be  dismounted  automatically  to  free  the  drive  for  CA-View  or  any  other 
application,  as  drives  are  not  dedicated  to  the  server. 


Memory  Management:  Reading  Ahead 

When  the  server  accesses  requested  blocks,  it  also  retrieves  additional  adjacent 
blocks  (NREAD  parameter).  These  data  blocks  are  buffered  into  memory  in 
anticipation  of  being  needed  as  a  user  scrolls  forward  while  browsing  a  report,  or 
issues  a  FIND  command,  etc. 

Re-Using  Buffers  When  the  tape  server  has  accessed  all  buffers  allocated  to  it  and  needs  to  re-use  a 

buffer,  it  does  the  following: 

1 .  Accesses  the  least  recently-accessed  buffer. 

2.  Reads  ahead  NREAD  number  of  blocks,  but  adjusted  down  s  it  does  not  re¬ 
read  an  already  buffered  block. 

3.  Frees  previous  blocks  when  a  forward  search  is  detected  to  prevent  forward 
search  users  from  taking  over  all  buffers. 
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Order  of  Media  When  a  user  selects  a  report  for  browsing  (selection  code  S  in  an  online  report 

Access  selection  list),  the  following  is  the  order  of  media  access: 

■  If  the  report  is  on  the  CA-View  DASD  database  (including  a  TEMP  DASD 
copy  that  was  loaded  back  to  disk),  it  is  accessed  from  DASD: 

■  If  the  report  is  not  on  DASD;  but  is  on  optical  disk,  it  is  accessed  from  optical 
disk. 

■  If  the  report  is  not  on  DASD  or  optical  disk,  it  is  accessed  by  the  expanded 
access  server. 

■  If  the  report  is  not  on  DASD  or  optical  disk,  and  the  expanded  access  server 
is  not  active,  the  tape  is  moimted  and  the  report  temporarily  LOADed  to 
disk,  assuming  there  is  mount  authority. 

LOAD  jobs  should  execute  on  the  system  with  the  primary  server;  otherwise, 
all  the  data  must  be  transmitted  across  systems  using  XGF  or  LSERV. 


Implementing  the  Expanded  Access  Server 

The  expanded  access  server  is  a  started  task.  The  following  is  a  sample  start 
procedure.  J€L  would  be  added  as  member  SAREAS  to  one  of  the  procedure 
libraries  defined  to  JES  (for  example  SYSl.PRGCLIB). 

//SABEAS  PROC 

/  /SAREAS  EXEC  PGM=SAEEAS,  TIME=1440>  PARM=  (  'parml' ,  'panB2 
//STEPLIB  DD  DSN=CA1.CAIL1B,DISP=SHR 

//SYSODOMP  DD  SYSOXJT=A 

Initialization  parameters  specified  in  the  PARM=  field  consist  of  a  keyword  and 
value  separated  by  an  equals  sign.  Omitting  the  value  specifies  the  default  value. 
Keywords  and  selectable  values  can  be  shortened  to  any  non-ambiguous  form  so 
the  parameters  can  fit  within^  the  100  character  length  limit  of  the  parameter  field. 

The  parameter  field  contains  the  following  initialization  parameters,  separated  by 
commas: 


GOMM=LSERV  I  XGF  The  conamunication  mechanism  to  be  used  by  the 

primary  and  secondary  servers 

LSERV  specifies  the  Gomputer  Associates  Server  Utility. 

XGF  specifies  the  MVS  Gross-System  Goupling  Facility. 

Note:  The  Gomputer  Associates  Server  Utility  has  XGF 
communications  capability  within  it.  All  servers  must 
use  the  same  communication  mechanism.  The 
parameter  is  meaningless  for  a  TYPE=ONLY  server.  The 
default  is  LSERV. 
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GOMM=LSERVIXCF 


DFQIDIi,E=n 


EASTNAME=JCJCx;c 


LSERVNAME=a::i:j:x 


MAXIDLE=n 


MBSniDLE=n 
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When  using  LSERV  for  the  communication  mechanism, 
ensure  that  the  LSERV  conununications  task  is  defined 
with  MAXSENDSIZE  of  33  (K)  or  larger  and  LCOMM  of 
YES. 

When  using  XGF  for  the  communication  mechanism:, 
the  group  name  is  the  value  for  EASTNAME,  and  the 
member  name  is  PRIMARY  for  the  primary  server,  and 
the  member  name  is  the  GPU  ID  for  the  secondary 
server. 

The  time  in  seconds  to  wait  for  requests  for  the  same 
optical  volume  to  accumulate  before  switching  to  a  new 
optical  volume  (tape  emulation  optical  only) 

This  parameter  works  in  conjtmction  with  exit 
SAREASUl  to  improve  performance.  Typical  values  are 
1  to  5  seconds. 

The  subsystem  name  of  the  expanded  access  server  for 
tape  and  robotics 

For  primary  and  secondary  servers,  this  is  also  the 
L-SERV  or  XGF  group  name.  The  default  is  LEAS. 

The  subsystem  name  of  the  Gomputer  Associates  Server 
Utility 

The  parameter  only  has  meaning  for  a  primary  or 
secondary  server  using  the  Gomputer  Associates  Server 
Utility  as  its  communication  mechanism.  The  default  is 
LSRV. 

The  maximum  time  in  seconds  that  a  tape  (or  platter  in 
the  case  of  tape  emulation  optical)  can  remain  imr 
accessed  before  it  will  be  un-allocated  for  the  primary  or 
TYPE=ONLY  server 

The  parameter  is  meaningless  for  a  secondary  server. 

The  default  is  10  minutes  (600). 

Note  that  for  the  primary  or  for  a  TYPE=ONLY  server, 
the  maximum  idle  time  wiU  be  adjusted  upwards  to  a 
minimum  of  MINIDLE. 

The  minimum  time  in  seconds  that  a  tape  (or  platter  in 
the  case  of  tape  emulation  optical)  must  be  moimted 
without  being  accessed  before  its  tape  processing  thread 
can  be  used  to  process  another  tape  volume  for  the 
primary  or  TYPE=ONLY  server 

The  parameter  is  meaningless  for  a  secondary  server. 

The  default  is  15  seconds. 
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MOUNT=DEFERI  REPLY 


NBUF=m 


NREAD=n 


NREQ=n 


NTHREADS=n 


Specifies  whether  the  tape  mounts  occur  during 
OPEN,  or  during  dynamic  allocation 

MOUNT=REPLY  gives  the  operator  a  moimt  request 
s/he  can  reply  to. 

The  default  is  DEFER>  which  gives  the  operator  no 
opportunity  to  reply  to  the  mount  request,  though 
mounts  can  occur  in  parallel. 

The  totalnumber  of  buffers  to  allocate 

Each  buffer  requires  32  K  bytes  of  virtual,  31-bit 
addressable  storage.  It  is  recommended  that  you  set 
NBUF  as  high  as  paging  and  real  storage  constraints 
will  allow.  The  default  is  50. 

Note  that  for  the  primary  or  only  server,  the  number 
of  buffers  wiU  be  adjusted  upwards  to  a  minimum  of 
(NTHREADS)  *  (NREAD). 

The  number  of  32K  tape  blocks  to  read  in  at  a  time, 
for  the  primary  or  only  server,  in  anticipation  of  their 
subsequent  use 

The  parameter  is  meaningless  for  a  secondary  server. 
The  default  is  4;  the  maximum  is  16. 

The  number  of  process  request  entries  to  pre-allocate; 
one  process  request  entry  is  needed  for  each  tape 
request  that  is  active  within  the  server 

If  more  entries  are  needed  at  any  given  time  than 
have  been  pre-allocated,  additional  entries  will  be 
allocated  and  freed  on  demand.  When  the  server  is 
stopped,  message  SAREA04I  is  produced  to  display 
the  "high  water  mark"  for  process  request  entries. 
The  default  is  200. 

The  number  of  tape  processing  threads  for  the 
primary  or  only  server 

The  parameter  is  meaningless  for  a  secondary  server. 
Each  tape  processing  thread  can  allocate  one  tape 
drive;  therefore,  specify  the  maximum  number  of 
tape  drives  you  would  like  to  be  available  to  the 
server.  The  default  is  4. 


;  ■  ) 


3-6  CA-View  System  Reference  Guide 


Expanded  Access  Server  for  Tape  and  Robotics 


TYPE=PRIMARY  I 
SECONDARY  I  ONLY 


The  type  of  server 

PRIMARY  specifies  that  this  server  is  to  perform  the 
tape  mounts  and  input  and  that  secondaiy  servers 
will  be  making  requests  from  it  via  L-SERV  or  XCF. 

SECONDARY  specifies  that  this  server  does  not 
perform  any  tape  moimts  or  input;  instead,  requests 
for  tape  blocks  are  made  via  L-SERV  or  XCF  to  the 
primary  server. 

ONLY  specifies  that  this  is  the  one  and  only  server;  it 
will  perform  all  of  its  own  tape  input,  and  no  L-SERV 
or  XCF  communications  will  be  established^ 

The  default  is  ONLY. 


Example 


O' 


The  follbwing  example  start  procedure  JCL  could  be  used  to  start  the  expanded 
access  server  for  tape  and  robotics: 


//SASEA.S  PROC 

//SARRAS  EXEC 

//  PAHM=('T=&TYPE', 

// 

//  'E=LEAS', 

//  'C=XCP', 

//  'MA=1800', 

// 

//  'NBa200>', 

//  'NREA=5', 

//  'NREQ=300', 

//  'NT=12')/ 
//STEPLIB  DD 

//SYSUDXniP  DD 


TYPE=OHLY 

P6M=SAREAS  ,  a<IME= 1440, 

TYPE  is  ONLY  by  default,  cbeuigeable  at 
startup 

EASTNAHE  is  LEAS 

COMM  is  XGP 

HAXXDLE  is  30  minutes 

HXNXDLB  is  10  seconds 

NBDF  is  200  buffers 

NRBAD  is  5  reads  at  a  time 

NREQ  is  300  process  request  entries 

NTHREADS  is  12  tape  threads  (drives) 

DSN=CAX . CAXLXB, DXSP=SHR 

SYSOUT=A 


Optimizing  Performance  of  the  Expanded  Access  Server 


The  following  parameters  should  be  examined  from  time  to  time  to  optimize 
performance  for  your  site's  particular  needs: 

MAXIDLE 

MINIDLE 

NBUF 

NREAD 

NREQ 

NTHREADS 


Excluding  Reports 
From  Expanded 
Access 


See  Server  Start-Up  Parameters  later  in  this  chapter  for  explanations. 

You  may  want  to  exclude  particular  reports  from  being  accessed  by  the  expanded 
access  server,  for  performance  or  security  reasons.  There  is  an  ERO  parameter, 
VIEWTAPE,  to  exclude  reports  from  access  by  the  expanded  access  server.  See 
the  section  Tape  Online  Access:  VIEWTAPE  in  Chapter  6,  "Expanded  Retention 
Option." 
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Compression  and 

Maximum 

Generations 


More  reports  on  tape  means  fewer  tapes,  and  fewer  necessary  tape  moimts.  You 
can  specify  that  CA-View  create  backup  tapes  utilizing  hardware  and/or 
software  compression.  See  the  initialization  parameter  TAPEOPT  in  Chapter  2, 
"Initialization  Parameters." 


i,  1 
'■ — ^ 


Initialization  parameter  MAXGENT  specifies  the  maximum  number  of 
generations  of  a  report  to  write  to  tape,  and  therefore  limits  the  number  of 
reports  written  to  any  one  tape.  You  can  want  to  increase  MAXGENT  for  tape 
storage  groups  that  contain  reports  that  are  browsed  from  tape  frequently. 
MAXGENT  is  a  subparameter  of  the  STORGRPO  and  STORGRP1-STORGRP9 
initialization  parameters. 


Tape  Storage  Groups  You  can  group  reports  on  tape  based  on  how  frequently  they  are  browsed  from 

tape.  This  way,  when  the  server  is  invoked,  it  is  more  often  reading  a  subset  of 
your  backup  tapes.  For  reports  that  will  not  migrate  to  optical  disk,  consider  how 
frequently  they  will  be  browsed  after  they  expire  from  primary  disk  when  you 
are  assigning  tape  storage  groups. 

Alternatively,  you  can  group  reports  based  on  their  retention  requirements.  One 
tape  storage  group  could  be  all  the  30-day  reports,  another  the  90-day  reports, 
etc.  This  lessens  the  need  for  tape  consolidation. 

For  information  about  tape  storage  groups,  see  STORGRPO  and  STORGRPl- 
STORGRP9  in  Chapter  2,  "Initialization  Parameters." 


Operating  the  Expanded  Access  Server  Task 

The  following  operator  commands  are  available  for  the  expanded  access  server 
started  task.  The  start  procedure  for  the  task  must  first  be  installed.  These 
examples  assume  the  JCL  from  the  preceding  example. 

■  To  start  the  server  as  a  stand-alone-only  server,  issue  the  following  operator 
command: 

S  SAREAS 

■  To  start  the  server  as  the  primary  server,  issue  the  following  operator 
command: 

S  SAREAS,TyPE=PRIMARY 

■  ■  To  start  the  server  as  a  secondary  server,  issue  the  following  operator 
command: 

S  SAREAS,TYPE=SECONDARy 

■  To  Stop  the  server,  issue  either  of  the  following  operator  commands: 

P  SAREAS 
F  SAREAS, STOP 
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■  If  a  coirununications  problem  occurs  (for  example,  L-SERV  is  shut  down  and 
restarted)  you  can  reset  communications  for  a  primary  or  secondary  server 
by  issuing  the  following  operator  command: 

F  SAREAS,COHHHESET 

Note  that  aU:  requests  awaiting  a  response  from  the  server  will  be  canceled. 

AU  tapes  currently  allocated  by  the  server  can  be  immediately  unloaded  by 
issuing  the  following  operator  command: 

F  SASEAS, UNLOAD 

Immediate  unload  can  be  useful  if  the  G  A- View  backup  cycle  or  the  SARPAG 
tape  consolidation  program  requires  a  tape  that  is  currently  mounted  by  the 
server. 


Job  Accounting 

CA-View  maintains  information  about  the  resources  used  by  each  archived 
SYSOUT  group.  The  information  includes: 

■  The  number  of  fbced-length,  3476-byte  blocks  written  on  disk 

■  The  number  of  lines  archived 

■  The  number  of  pages  archived 

In  addition/  CA-View  keeps  up  to  20  bytes  of  user  accounting  data  for  each 
SYSOUT  group. 


Accounting  Report  Program  (SARACT) 

An  accounting  report  program,  SARACT,  is  supplied  with  CA-View.  The 
program  produces  a  listing  of  the  resources  described  m  the  previous  section 
used  by  the  archived  SYSOUT  groups  in  order  of  account  number.  Due  to  the 
varied  accoimting  requirements  of  CA-View  users,  the  program  is  supplied  in 
source  fonm  The  program  is  written  in  both  COBOL  and  assembler  and  is  easily 
modified.  The  source  for  the  program  is  in  VIEW.SOURCE.  You  must  compile 
and  link-edit  the  program  before  executing  it. 


The  COBOL  version  of  this  program  requires  the  use  of  IBM's  COBOL  VS  I 
compiler.  You  can  modify  the  source  module  to  adhere  to  the  COBOL  VS  II 
compiler  standards. 

Input  to  the  SARACT  program  is  a  sequential  copy  of  the  master  index.  You  must 
use  the  IDXOUT  function  of  the  SARDBASE  program  to  create  the  sequential 
copy  of  the  master  index. 

1  i 

Vw--' 
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JCL  to  Execute  Accounting 


Once  SARACT  has  been  compiled  and  link-edited,  the  following  JGL  executes  the 
accounting  report  program: 

II SARACT  JOB  ACCOUNT, PROGRAMMER 

II* 

II*  EXECUTE  SARDBASE  TO  COPY  THE  MASTER 

//*  INDEX  TO  &&IDX 

//* 

//IDXOUT  EXEC  PGM=SARDBASE 

//STEPLIB  DD  DSN=CAI.CAIL1B,D1SP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SARIOUT  DD  DSN=&SeIDX,DlSP=(,PASS);, 

/ /  UN1T=SYSDA, SPACE= ( CYL ,(1,1)) 

//SYSIN  DD  * 

NAME  VIEW.SYSTEMl 
IDXOUT 
//* 

//*  EXECUTE  SARACT  TO  PROCESS  FILE  St&IDX 

//* 

/ /SARACT  EXEC  P6M=SARACT 

//STEPLIB  DD  DSN=CAI.CAILIB,DISP=SHR 

//S2UIIDX  DD  DSN=&SeIDX,DISP=(  OLD,  DELETE) 

//PRINT  DD  SYSOUT=* 

//SYSOUT  DD  SYSOUT=* 

//SORTWKOl  DD  UNIT=SYSDA,SPACE= (CYL, (1, 1) ) 

//SORTWK02  DD  UNIT=SYSDA, SPACE= (CYL, (1,1) ) 

//SORTWK03  DD  UNIT=SYSDA,SPACE= (CYL, (1, 1) ) 

■  If  the  load  modules  are  link-edited  into  a  library  other  than  one  of  the  link  list 
libraries,  change  the  data  set  name  on  the  STEPLIB  DD  statements,  if 
necessary. 

■  If  the  load  modules  are  link-edited  into  a  link  list  library,  remove  the 
STEPLIB  DD  statements. 

■  Change  the  high-levelname  on  the  NAME  control  statement  to  the  name  of 
your  database. 

■  The  SYSOUT  DD  statement  defines  the  SORT  messages  and  can  be  dummied 
out  if  desired. 

■  The  PRINT  DD  statement  must  define  a  sequential  output  file  to  contain  the 
report. 


Capturing  Accounting  Data  From  the  JOB  Statement 


By  the  time  a  job's  SYSOUT  is  queued  for  output  processing  and  passed  to  the 
archival  started  task,  its  accoimting  data  is  no  longer  available  using  the  standard 
subsystem  interface.  To  get  around  this  problem,  the  accounting  data  for  a  job,  or 
time-sharing  session,  is  written  to  a  CA-View  accoimting  file  at  job  initiation  time 
via  CA-View  system  extensions.  This  accoimting  file  is  then  made  available  to  the 
archival  started  task. 
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If  job  accotmting  data  is  required  by  your  site,  the  accounting  file  must  be 
allocated  to  DD  name  SARACT  in  the  SARXTD  system  extensions  and  SARSTG 
archival  task  procedures.  CA-View  system  extensions  must  be  established  on 
each  processor  at  your  site  that  executes  any  job  or  time-sharing  session  that 
produces  SYSOUT  for  archival.  Also,  you  must  create  and  format  the  CA-View 
accoimting  file.  See  System  Extensions  (SARXTD)  later  m  this  chapter,  and  in 
Appendix  A,  "Data  Sets  and  Environmental  Considerations,"  for  a  description  of 
the  accoimting  file. 


JCL  Errors  and  TYPRUN=SCAN 

Because  accoimting  data  is  not  captured  until  job  initiation,  no  accoimting  data  is 
provided  for  SYSOUT  for  a  job  having  a  syntax  JCL  error  or  for  a  job  for  which 
TYPRUN=SCAN  was  specified  on  the  JOB  statement. 


User  Exits 


A  user  exit,  SARACTUX,  is  provided  to  extract  accoimting  data  from  the  type-20 
SMF  records.  The  standard  user  exit  supplied  with  CA-View  extracts  the  first  10 
bytes  of  the  first  accoimting  field  and  the  first  10  bytes  of  the  second  accoimting 
field,  for  a  total  of  20  bytes.  If  either  field  is  shorter  than  10  bytes,  it  is  padded  on 
the  right  with  blanks.  See  Chapter  11,  "User  Exits,"  for  information  about 
modifying  the  user  exit. 

When  the  direct-to-CA-View  archival  feature  of  CA-Deliver  is  used,  accounting 
data  is  extracted  and  formatted  by  the  GA-Deliver  RMORRQUX  user  exit. 


SMF  Type-6  Records 

CA-View  produces  special  type-6  SMF  records  for  any  SYSOUT  groups 
automatically  printed  by  the  archival  started  task  when  mitialization  parameter 
SMF=YES  has  been  specified. 

The  format  of  the  type-6  SMF  records  is  as  follows: 


Offset 

Name 

Length 

Contents 

(dec.) 

(chars.) 

0 

SMF6LEN 

2 

Record  length  in  binary 

2 

SMF6SEG 

2 

Segment  descriptor 

4 

SMF6FLG 

1 

System  indicator  for  VS2  (X'02') 

Continued 
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Continued 


Offset 

Name 

Length 

Contents 

(dec.) 

(chars.) 

5 

SMF6RTY 

1 

Record  type  (X'06') 

6 

SMF6TME 

4 

Time  in  binary,  in  hundredths  of  a  second, 
that  the  record  was  moved  to  SMF  buffer 

10 

SMF6DTE 

4 

Date  that  the  record  was  moved  to  SMF 
buffer,  in  the  form  OOYYDDDF  where  F  is 
the  sign 

14 

SMF6SID 

4 

System  identification  (taken  from  SID 
parameter) 

18 

SMF6JBN 

8 

Job  name 

26 

SMF6RST 

4 

Time  in  binary,  in  hundredths  of  a  second, 
that  the  reader  recognized  the  job  card  for 
this  job 

30 

SMF6RSD 

4 

Date  that  the  reader  recognized  the  job  card 
for  this  job,  in  the  form  OOYYDDDF  where  F 
is  the  sign 

34 

SMF6UIF 

8 

User  identification 

42 

SMF60WG 

1 

SYSOUT  class 

43 

SMF6WST 

4 

Start  time  in  binary,  in  hundredths  of  a 
second,  that  CA-View  printed  the  SYSOUT 

47 

SMF6WSD 

4 

Date  that  CA-View  printed  the  SYSOUT,  in 
the  form  OOYYDDDF  where  F  is  the  sign 

51 

SMF6NLR 

4 

Number  of  lines,  in  binary,  printed  for  all 
copies 

55 

SMF6IOE 

1 

X'OO' 

56 

SMF6NDS 

1 

Number  of  copies  printed 

57 

SMF6FMN 

4 

Form  number 

61 

SMF6PAD1 

1 

Section  indicator  (X'80'-3800  Printing 
Subsystem  section  present) 

62 

SMF6SBS 

2 

Subsystem  identification  (C'ES') 

Continued 
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Continued 


Offset 

(dec.) 

Name 

Length 

(chars.) 

Contents 

64 

SMF6LN1 

2 

Length  of  rest  of  record,  including  this  field, 
but  not  including  any  additional  sections 
indicated  by  the  SMF6PAD1  field 

66 

SMF6DCI 

2 

X'OOOO' 

68 

SMF6JNM 

4 

Job  number 

72 

SMF60UT 

8 

SYSOUT  destination 

80 

SMF6FCB 

4 

FCB  image  identification 

84 

SMF6UGS 

4 

UCS  image  identification 

88 

SMF6PGE 

4 

Number  of  pages,  in  binary,  printed  for  all 
copies 

92 

SMF6DFE 

2 

X'OOOO' 

94 

SMF60PR 

2 

X'OOOO' 

96 

SMF6GRP 

8 

X'OOOOOOOOOOOOOOOO' 

104 

SMF6RSVJ 

8 

First  8  characters  of  SYSOUT  K)' 

112 

SMF6RSVU 

4 

Last  4  characters  of  SYSOUT  ID 

SMF  Type-6  Record  for  3800  Printers 

The  format  of  the  type-6  SMF  record  for  the  3800  printer  subsystems  sections  is  as 
follows: 


Offset 

(dec.) 

Name 

Length 

(chars.) 

Contents 

0 

SMF6LN2 

2 

Length  of  3800  Ptinting  Subsystem  section, 
including  this  field 

2 

SMF6CPS 

8 

Number  of  copies  printed  in  each  group 

Each  byte  represents,  in  binary,  one  copy 
group;  the  sum  of  the  8  bytes  is  the  total 
number  of  copies  printed. 

10 

SMF6CHR 

16 

Names  of  the  character  arrangement  tables 
that  define  the  characters  used  in  printing 

Each  name  is  4  bytes  long,  with  a 
maximum  of  4  names. 

Continued 
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Continued 


Offset 

(dec.) 

Name 

Length 

(chars.) 

Contents 

26 

SMF6MID 

4 

Name  of  copy  modification  module  used 
to  modify  the  data 

30 

SMF6FLI 

4 

Name  of  the  forms  overlay  printed  on  the 
copies 

34 

SMF6FLC 

1 

Number  of  copies,  in  binary  on  which  the 
forms  overlay  is  printed 

35 

SMF6BID 

1 

Options  indicator: 

X'80'  Output  is  to  be  burst  into  sheets 
by  the  Burster-Trimmer-Stacker 

X'40'  DCB  subparameter  OPTCD=J  was 
specified 

Formatting  the  CA-View  Accounting  File 

The  SARINACT  program  formats  the  CA-View  accounting  file.  The  accoimting 
file  is  only  required  if  job  accoimting  is  desired  as  a  GA- View  extension. 

The  following  job  control  statements  are  required: 


Statementi 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (for  example,  PGM=SARINAGT) 

STEPLIBDD 

Defines  the  load  library  containing  SARINACT 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRINTDD 

Defines  the  sequential  output  data  set  (normally  SYSOUT) 
used  for  listing  the  statements  and  messages 

If  not  a  SYSOUT  data  set,  DGB=BLKSIZE=nnn  must  be 
coded,  where  nnn  is  a  multiple  of  121. 

SARACT  DD 

Defines  the  accounting  file 

The  data  set  must  be  allocated  as  one  contiguous  extent  with 
sufficient  disk  space  to  contain  32768  28-byte  accounting 
records.  The  default  and  recommended  block  size  is  2800  (100 
accounting  records  per  block). 
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Example 


The  following  job  creates  and  initializes  the  CA-View  accounting  file, 
VIEW.SARAGT: 


//AGTINIT 

//SARINAGT 

//STEPLIB 

//SYSPRINT 

//SAHACT 

// 

H 


JOB  AGGOXmX,  PROGRAHMER 
EXEG  P6H=SARZIIACT 
DD  DSN=GAZ . CAXLXB, DXSP=SHR 
DD  SYSOUT=* 

DD  DSN=VIBW.  SARAGT,  DISP=  (:,  GATLG)  , 
DNXT=SYSnA,  VOL=SER=nimnnii, 
SPAGE= (2800, 328,  ,CONTXG) 


Microfiche  Processing  with  SARMFP 

The  SARMFP  program  creates  a  sequential  output  file  in  a  format  suitable  for 
microfiche  processing.  The  output  file  can  be  processed  by  a  microfiche  reformat 
utility  to  produce  a  COM-ready  tape  or  can  be  microfiched  directly  by  an 
intelligent  microfiche  processor. 

Only  SYSOUT  groups  archived  on  disk  can  be  microfiched.  SYSOUT  groups 
archived  directly  to  tape  or  those  having  cycled  off  their  disk  generations  are 
skipped  over  by  the  program. 

Initialization  parameters  MSORTl,  MSORT2,  etc.,  specify  the  order  in  which  the 
SYSOUT  groups  residing  in  disk  archival  data  sets  are  sorted  for  output. 


Separator  Record 


The  archived  SYSOUT  groups  are  written  sequentially  to  the  output  file.  A 
special  separator  record  proceeds  each  group.  Data  from  the  separator  record  can 
be  used  to: 

■  Identify  the  SYSOUT 

■  Create  an  index  for  the  fiche 

■  Produce  imderstandable  titles 

The  special  separator  record  is  formatted  as  follows: 


Position 

Length 

Contents 

1 

1 

Record  identifier  constant  X'73' 

2 

3 

Record  identifier  constant  'SARf 

5 

12 

SYSOUT  ID 

Continued 
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Continued 


Position 

Length 

Contents 

17 

8 

Job  name 

25 

8 

Job  ID 

33 

8 

Archival  date  (mm/dd/yy) 

41 

8 

Archival  time  {hh:mm:ss) 

49 

8 

Lines  archived 

57 

8 

Pages  archived 

65 

6 

Exceptional  condition 

User  Exit  for  Formatting  Output 

A  user  exit,  SARMFPUX,  is  available  for  special  formatting  of  the  output  file. 

The  SARMFP  program  must  run  as  a  started  task.  It  is  executed  with  the 
following  command: 

S  SABMFP[,pPT='£reneratioii'] 

where  generation  is  the  absolute  (unsigned  number)  or  relative  (negative  number) 
generation  number  to  be  output  to microfiche.  To  output  the  current  generation 
to microfiche,  the  OPT  parameter  can  be  completely  omitted  from  the  command, 
or  the  generation  could  be  specified  as  -0. 


SARMFP  Examples 


The  following  examples  invoke  the  microfiche  task  for  different  sets  of  SYSOUT 
generations. 

Example!  s  sarmfp,opt='-1' 

Specifies  that  CA-View  is  to  invoke  the  microfiche  facility  for  SYSOUT  in  the 
previous  archival  generation. 

Example  2  s  sasmfp,opt='23' 

Specifies  that  CA-View  is  to  invoke  the  microfiche  facility  for  SYSOUT  in  the 
archival  generation  23; 
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Examples  s  sarmfp 

Specifies  that  CA-View  is  to  invoke  the  microfiche  facility  for  SYSOUT  in  the 
current  archival  generation. 


Batch  Job  Execution  of  the  Microfiche  Task 


Although  the  microfiche  program  is  distributed  for  execution  as  a  started  task,  it 
is  possible  to  run  this  program  as  batch  job  after  first  modifying  it  with  the  IBM 
AMASPZAP  utility. 

To  modify  the  microfiche  program  so  that  it  can  be  run  as  a  batch  job,  execute  the 
following  job: 

/ /FICHEZAP  JOB  ACCOUHT, PROGRAMMER 
//STZT?!  EXEC  PGM=AMASPZAP 
//SYSPRINT  DD  SYSOUT=* 

//SYSLXB  DD  DSN=CA1.CAII>XB,DISP=SHR 
//SYSXH  DD  * 

NAME  SARMFP  SARMFP 
VER  06  00 
REP  06  FF 
/* 


Change  the  data  set  name  on  the  SYSLIB  DID  statement  to  the  name  of  the  library 
containing  the  GA-View  load  modules. 


External  Printing 

The  external  print  interface  is  a  direct  interface  between  CA-View  and  any 
printing  product  that  might  be  used  to  reprint  a  SYSOUT  or  report.  CA-View 
communicates  directly  with  these  external  printing  products  via  initialization 
parameters  and  online  specifications. 


Printing  to  External  Devices 


You  identify  a  SYSOUT  group  and  all  of  its  attributes  for  printing  with  a  external 
print  record  (XPR).  You  specify  these  attributes  with  the  EXTPRTn  initialization 
parameters.  You  can  identify  up  to  three  separate  attributes  with  the  EXTPRTl, 
EXTPRT2,  and  EXTPRT3  initialization  parameters. 

Each  EXTPRT  initialization  parameter  contains  a  1-  to  3-character  identifier  for 
the  printing  product,  and  can  contain  attributes  for  defining  the  communication 
mechanism. 
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Interfaces  for  External  Printing 

There  are  two  interfaces  for  use  by  CA-View  to  pass  the  External  Print  Record 
(XPR)  to  the  external  printing  product.  They  are: 

■  The  JES  data  set  interface 

■  The  d3mainic  program  call  interface 

The  format  of  EXTPRTn  parameters  determines  which  of  the  two  CA-View 
external  printing  interfaces  will  be  invoked. 

The  currently-available  external  printing  interface  is  to  VPS  Print,  using  the  JES 
data  set  interface.  If  you  would  like  Computer  Associates  to  develop  an  interface 
to  another  product,  you  can  fill  out  a  Demand  Analysis  Request  (DAR)  form, 
available  from  Computer  Associates  Technical  Support. 

The  external  print  interface  may  require  a  special  maintenance  or  release  level  of 
the  vendor  printing  product.  Please  contact  the  vendor  for  details. 


Defining  an  EXTERNAL  Device 

To  simplify  specification  at  reprint  time,  you  can  define  an  EXTERNAL  printing 
device  with  the  online  DEFINE  DEVICE  (DEF  DEV)  coiiunand.  Your  system 
administrator  can  use  the  online  DEF  DEV  command  to  assign  a  printer  alias 
name  (such  as  PRINTRl)  to  simplify  specifying  an  external  printer.  See  the 
"System  Administration"  chapter  of  the  CA-View  Online  User's  Guide  for 
information  on  defining  output  devices  with  DEF  DEV. 


JES  Data  Set  Interface 


With  this  interface,  CA-View  dynamically  creates  a  single-record  JES  data  set 
containmg  an  external  print  control  record.  The  record  is  written  as  a  fixed-length 
record  without  any  carriage  control.  The  data  set  is  routed  to  the  external  print 
product  based  upon  a  combination  of  class,  destination,  forms  name,  and  writer 
name  as  determined  from  the  EXTPRTn  initialization  parameter  and  the 
destination  specified  by  the  user  on  the  print  request: 


EXTPRTn  Parameters 


For  the  JES  data  set  interface,  the  EXTPRTn  initialization  parameter  has  the 
following  format: 

EXTPRTxi=printer-id/JESDS/class/d®sfcination/form/Writer 


3-18  CA-View  System  Reference  Guide 


External  Printing 


where: 

n 

Specifies  either  1,  2,  or  3 

printer-id 

Specifies  the  1-  to  3-character  identifier  for  the  external  print 
product 

class 

Specifies  the  1-character  SYSOUT  class  to  be  used  to  route  the 
external  print  record 

destination 

Specifies  the  8-character  SYSOUT  destination  to  be  used  to  route 
the  external  print  record 

form 

Specifies  the  4-character  SYSOUT  forms  name  to  be  used  to 
route  the  external  print  record 

writer 

Specifies  the  8-character  SYSOUT  writer  name  to  be  used  to 
route  the  external  print  record 

EXTPRTn  Parameters  and  Online  Print  Specifications 

One  or  more  of  the  following  EXTPRTn  parameters  can  be  specified  as  an  asterisk 
to  indicate  that  they  are  to  be  supplied  online  by  the  user  when  printing  a 
SYSOUT  group: 

class 

destination 

form 

writer 

Example  Assume  you  want  to  print  to  an  external  device  using  the  JES  data  set  interface. 

Also  assume  the  following: 

■  The  printer  ID  is  VPS 

■  The  class  is  V 

■  The  destination  is  LOCAL 

■  You  want  the  writer  name  to  be  supplied  online  when  the  print  request  is 
made 

You  would  define  the  following  initialization  parameter: 

EaCTPRTl=VI>S  /  JESDS  /V/LOCAL/ /* 


For  the  online  print  request  you  would  specify  the  following  destination: 
DEST  ===>  >VPS.FMT5 

CA-View  would  dynamically  create  a  SYSOUT  data  set  to  contain  the  XPR 
record.  The  attributes  for  the  data  set  would  correspond  to  the  following  JCL 
statement: 

//ddname  DD  SYSOUT={V,EMT5) ,DEST=LOCAL 
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Notice  the  use  of  the  asterisk  in  the  EXTPRT  parameter  in  the  writer  position  to 
indicate  that  the  user  will  supply  the  writer  name  online  at  the  time  of  the  print 
request. 


EXTERNAL  Printing-Dynamic  Program  Call  Interface 

With  the  dynamic  program  call  interface,  CA-View  dynamically  loads  and  calls  a 
program  to  handle  the  print  request.  The  external  print  record  (XPR)  is  passed  to 
the  program  as  well  as  the  parameter  data  specified  in  the  EXTPRTn  initialization 
parameter  and  in  the  destination  specified  by  the  user  on  the  print  request. 


EXTPRTn  Parameters 


For  the  dynamic  program  call  interface,  the  EXTPRTn  initialization  parameter  has 
the  format; 

EX.TPRl!n=printer-id/PGU/progrram-name/pareUfieter-data 
where: 

n 

printer-id 
program-name 
parameter-data 

Example  Assume  you  want  to  print  to  an  external  device  using  the  dynamic  program  call 

interface.  Also  assume  the  following: 

■  The  printer  ID  is  ANA. 

■  The  program  to  be  called  is  ANAEP. 

■  The  characters  NOBANNER  are  to  be  passed  to  the  program. 

You  would  define  the  following  initialization  parameter: 

EXTPRT2  =aNA/PG«/ANaEP /NOBANNER 

For  the  online  print  request,  you  would  supply  the  following  destination; 

DEST  ===>  >ANA. INDEX 


Is  either  1, 2,  or  3 

Specifies  the  1-  to  3-character  identifier  for  the  external  print 
product 

Specifies  the  8-character  name  of  the  interface  program  to  be 
called 

Specifies  up  to  14  characters  of  parameter  data  to  be  passed  to 
the  interface  program 
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CA-View  would  d}mainically  load  and  call  the  program  ANAEP.  The  parameter 
list  to  the  program  would  contain  the  addresses  and  lengths  of  the  following: 

■  The  character  string  NOBANNER 

■  The  character  string  INDEX 

■  The  XPR  record 


3800  Printer  Attributes 

CA-View  captures  and  archives  information  on  the  3800  printer  attributes  for 
SYSOUT  produced  under  the  JES2  job  entry  subsystem;  however,  imder  the  JESS 
job  entry  subsystem,  this  information  is  not  readily  available  to  CA-View  and  is 
not  archived  with  the  SYSOUT. 

When  printing  SYSOUT  under  the  MVS/SP  1.3.2  (or  a  later  release)  operating 
system,  CA-View  uses  the  3800  printer  attributes  originally  archived  with  the 
SYSOUT,  along  with  any  other  overrides  specified  with  the  online  or  batch 
request,  to  print  the  SYSOUT.  For  earlier  releases  of  MVS,  dynamic  allocation 
does  not  support  the  3800  attributes,  so  CA-View  ignores  the  attributes  when 
printing  SYSOUT. 

Also,  in  order  for  CA-View  to  use  any  of  the  3800  printer  attributes  (for  example, 
BURST,  CHARS,  or  MODH^)  when  printing  reports,  the  operating  system  must 
be  at  release  level  MVS/SP  1.3.2dr  later.  The  reason  for  this  requirement  is  that 
CA-View  uses  the  dynamic  allocation  facilities  of  the  operating  system,  and 
earlier  releases  of  MVS  do  not  support  3800  printer  attributes  for  dynamic 
allocation. 


/‘OUTPUT  JES2  Control  Statement 

The  /^OUTPUT  JES2  control  statement  is  not  supported  directly  by  CA-View 
because  the  parameters  on  the  statement  are  kept  on  the  JES2  spool  volume  and 
are  not  available  to  CA-View.  Instead,  CA-View  obtains  the  print  attributes  for  a 
report  from  the  internal  representation  of  the  DD  and  OUTPUT  JCL  statements 
(that  is,  from  the  JFCB>  SIOT,  and  SWB  control  blocks). 

Note  that  since  CA-View  does  not  use  the  /^OUTPUT  control  statement,  JES2  can 
still  apply  the  statement  to  a  report  DD  statement  dynamically  allocated  by 
CA-View.  Specifically,  JES2  applies  a  /^OUTPUT  statement  when  the  DD 
statement  dynamically  allocated  by  CA-View  contains  a  forms  name  equal  to  the 
code  identifier  on  the  /^OUTPUT  control  statement.  When  applying  the 
/^OUTPUT  statement,  parameters  are  added  to  or  replace  those  on  the  DD 
statement; 
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//‘FORMAT  JESS  Control  Statement 

The  /  /^FORMAT  JES3  control  statement  is  not  supported  directly  by  CA-View 
because  the  parameters  on  the  statement  are  kept  on  the  JES3  spool  volume  and 
are  not  available  to  CA-View.  Instead,  CA-View  obtains  the  print  attributes  for  a 
report  from  the  internal  representation  of  the  DD  and  OUTPUT  JCL  statements 
(that  is,  from  the  JFCB>  SIOT,  and  SWB  control  blocks). 

Note  that  although  CA-View  does  not  use  the  //’^FORMAT  control  statement, 
JES3  can  stiU  apply  the  statement  to  a  report  DD  statement  dynamically  allocated 
by  CA-View.  Any  non-specific  //^FORMAT  statement  (for  example,  the 
/ /*FORMAT  statement  contains  DDNAME=)  is  applied;  however,  only  those 
parameters  not  specified  by  CA-View  to  dynamically  allocate  the  DD  statement 
are  used.  It  is  unlikely,  however,  that  any  specific  //^FORMAT  statement  (for 
example,  the  / /^FORMAT  statement  contains  DDNAME=ddnflme)  is  applied, 
since  the  DDNAME  of  the  dynamically-allocated  DD  statement  is  generated  by 
the  operating  system. 


//OUTPUT  JCL  Statement 


CA-View  extracts  print  attributes  from  /  /OUTPUT  statements  and  d5mamically 
creates  /  /OUTPUT  statements  as  necessary  to  produce  reports,  following  the 
same  rules  used  by  the  operating  system  for  overrides.  Note  that  if  a  SYSOUT 
DD  statement  references  more  than  one  //OUTPUT  statement,  CA-View  only 
uses  the  first  statement  to  obtain  the  print  attributes;  the  other  statements  are 
ignored. 


Specifically,  CA-View  extracts  print  attributes  for  the  following  /  /OUTPUT 
parameters: 

BURST 

CHARS 

CIASS 

COFTES 

DEST 

FCB 

FliASH 

FORHDEF 

FORKS 

LJHECT 

MODIFY 

FA6EDEF 

FRHODE 

UCS 

WRITER 


Note:  CA-View  extracts  /  /OUTPUT  attributes  only  for  reports  archived 
through  the  Automatic  Report  Archival  feature  of  CA-View  Systems  Extensions. 
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Recovery  Data  Set 

The  CA-View  recovery  data  set  is  used  by  the  archival  started  task  and  during 
the  recovery  process  to  maintain  and  obtain  information  on  the  tapes  used  in  the 
backup  process.  This  data  set  is  referenced  by  the  SAR3REGV  DD  statement  in  the 
started  task  JCL  for  the  archival  task  and  in  the  batch  JCL  for  the  SARDBASE  and 
SARRECOV  utilities. 


Note:  The  data  set  must  reside  on  a  direct  access  volume.  Since  the  data  set  is 
used  to  recover  the  CA-View  database,  you  should  not  place  the  recovery  data 
set  on  the  same  volumes  containing  data  sets  for  the  CA-View  database. 

The  data  set  must  not  be  allocated  with  DCB  attributes.  Only  one  track  can  be 
allocated  for  this  data  set. 


Example 


The  following  job  is  submitted  to  create  the  recovery  data  set: 


//CREATE 

//XEFBR14 

//DDl 

// 


JOB  ACCOUNT, PROGRAMMER 
EXEC  P6H=XEFBR14 

DD  DSN=VXEW,.SARRECV,  DISP=  (  ,  CATLG)  , 
UNIT=SYSDA,  VOL=SER=VOL380 , SPACE= (TRK, 1 ) 


Security 

CA-View  provides  the  following  security  features: 

■  Logon  user  exits 

■  Internal  security  user  exit  (SARSECUX) 

■  External  security  (RACE,  CA-CA-ACF2,  etc.)  via  SAP  user  exit  calls 

■  Batch  password  protection 

■  Data  set  security 

You  can  select  one  or  more  of  these  features  as  necessary. 


Logon  Seourity 

CA-View  logon  security  is  controlled  by  the  SARUSxUX  user  exits.  See 
Chapter  11,  "User  Exits,"  for  details  about  implementation: 
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Internal  Security  User  Exit:  SARSECUX 


You  can  use  user  exit  SARSEGUX  to  restrict  access  to  archived  SYSOUT  groups. 
For  the  online  retrieval  facility,  this  exit  is  invoked  for  each  entry  to  be  displayed 
in  the  SYSOUT  selection  list.  It  is  invoked  again  whenever  an  entry  in  the 
SYSOUT  selection  list  is  selected  for  processing.  By  setting  a  return  code 
indicating  whether  you  are  authorized  to  access  the  SYSOUT  group,  the  exit 
either  allows  the  entry  to  be  displayed  or  prevents  it  from  being  displayed  in  the 
list. 

For  the  batch  retrieval  program,  SARSECUX  is  invoked  for  each  entry  to  be  listed 
as  a  result  of  the  LIST  function.  This  exit  is  also  invoked  whenever  a  SYSOUT 
group  is  selected  by  the  PRINT  or  LOAD  functions.  By  setting  a  return  code 
indicating  whether  the  job  is  authorized  to  access  the  SYSOUT  group,  the 
function  is  either  allowed  or  failed,  as  appropriate. 

CA-View  also  provides  security  at  the  report  level  via  user  modes  and  private 
report  viewing.  See  the  CA-View  Online  User's  Guide  for  details. 


External  Security  Interface 

External  security  packages  are  invoked  by  calling  SAF.  See  RAGF  and  Online 
Interfaces  later  in  this  chapter  for  a  list  of  the  exits  that  make  SAF  calls  to 
interface  to  external  secvuity. 


Batch  Password  Protection 

For  backgroimd  jobs  submitted  by  the  online  retrieval  facility,  complete  security 
checking  is  done  before  the  job  is  ever  submitted.  In  this  case,  there  is  no  need  for 
the  batch  retrieval  program  to  perform  security  checking,  provided  that  the 
background  job  was  submitted  by  the  online  retrieval  feature. 

You  use  the  PWBATGH  initialization  parameter  to  eliminate  the  need  for  the 
batch  retrieval  program:  to  perform  security  checking.  When  you  specify  the 
PWBATGH  parameter,  the  online  retrieval  feature  adds  the  password  to  each 
backgroimd  function  requested.  The  batch  retrieval  program  then  verifies  that 
the  password  matches  the  one  specified  with  the  PWBATGH  initialization 
parameter.  If  the  password  mat Aes,  no  further  security  checking  is  done. 


Data  Set  Security 


GA-View  provides  full  security  over  its  data  sets  as  a  GA-View  system  extension. 
Full  security  means  that  no  programs  other  than  GA-View  programs  (unless 
authorized  to  bypass  password  protection)  can  access  the  data  sets. 
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RACF  Example 


RACF  protection  is  available  to  restrict  access  to  individual  SYSOUT  groups 
using  the  RACF  option.  When  you  specify  the  RACF  option,  CA-View  issues  a 
RACHECK  for  a  SYSOUT  group  before  allowing  access  to  it.  To  browse  a 
SYSOUT  group  or  load  itto  disk,  you  or  the  job  must  have  READ  access  to  it;  to 
print  a  SYSOUT  group,  you  or  the  job  must  have  UPDATE  access  to  it;  to  delete  a 
SYSOUT  group,  you  must  have  ALTER  access  to  it. 

The  entity  for  which  GA-View  does  a  RACHECK  is  a  "pseudo"  data  set  that  has  a 
name  in  the  following  form; 

index. id 

(if  the  SYSOUT  ID  is  1  to  8  characters) 
or 

index. suhid-l . $subid-2 

(if  the  SYSOUT  ID  exceeds  8  characters) 
where: 

index  Specifies  the  value  specified  with  the  RACF  option 

id  Specifies  the  fuU  SYSOUT  ID 

subid-1  Specifies  characters  1  through  8  of  the  SYSOUT  ID 

subid-2  Specifies  the  remaining  characters  of  the  SYSOUT  ID  beginning 

with  the  ninth  character 

The  volume  serial  number  used  for  the  RACHECK  is  the  value  specified  with  the 
RACF  option.  It  is  a  "dummy"  serial  number  and  need  not  represent  an  actual 
volume. 

Assuming  the  option  RAGF=SAR  has  been  specified,  the  following  data  sets  are 
RACHEGKed  by  CA-View  whenever  access  to  the  specified  SYSOUT  groups  is 
requested: 


SYSOUT  ID 

DataSet  Name 

Volser 

REPORTX 

VIEW.REPORTX 

SAR 

PRODJOBR275 

VIEW.PRODJOBR.$275 

SAR 
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To  restrict  access  to  a  SYSOUT  group,  the  site  must  add  a  data  set  descriptor  for  it 
to  the  RAGF  data  set.  The  ADDSD  TSO  command  is  used  to  perform  this 
function. 

The  S5mtax  of  the  ADDSD  command  as  applicable  to  CA-View  is: 

ADDSD'  •  data.- set -name'  VOLUME  (volser)  UNXT(X)  NOSET 
where: 

data-set-name  Specifies  the  "pseudo''  data  set  name  for  the  SYSOUT  group 
volser  Specifies  the  value  of  the  RACF  option 

Note:  The  UNIT  operand  is  required  on  the  command;  however,  its  value  is 
meaningless  since  the  NOSET  operand  is  also  specified. 

Once  access  to  a  SYSOUT  group  has  been  restricted  with  the  ADDSD  TSO 
command,  access  to  it  can  be  given  to  specific  users  or  groups  with  the  PERMIT 
TSO  conunand. 

PERMIT  Command  and  RACF 

The  syntax  of  the  PERMIT  command  as  applicable  to  CA-View  is: 

PERMIT  ' data-set-name'  ID(user)  XCCitype) 
where: 

data-set-name  Specifies  the  "pseudo"  data  set  name  for  the  SYSOUT  group 

user  Specifies  the  name  of  the  user  or  group  to  which  access  is  to  be 

granted 

type  Specifies  the  type  of  access  to  be  given:  READ  or  UPDATE 

Assume  access  to  SYSOUT  group  PRODJOBR275  is  restricted  to  all  users  except 
the  following: 

■  User  APPIlUSR  is  allowed  to  only  browse  the  SYSOUT  group. 

■  User  OPERUSRis  allowed  full  access  to  the  data  set  (for  example,  browse, 
print,  and  load). 

■  User  AUTHUSR  is  allowed  full  access  to  the  data  set  (for  example,  browse, 
print,  and  load). 

Also,  option  RACF=SAR  has  been  specified. 


RACF  Example  Using 
PERMIT 
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— ' 

The  following  TSO  coirunands  are  issued: 

ADDSD  ' VIEW. PRODJOBR. $275'  VOLOME(SAR)  UNIT(X)  NOSET 
PERMIT  'VIEW. PRODJOBR. $275'  ID(APPLUSR)  AGG(READ) 
PERMIT  'VIEW. PRODJOBR. $275'  ID(OPERUSR)  AGG(UPDATE) 
PERMIT  'VIEW. PRODJOBR. $275'  IDfAUTHUSR)  AGG{ALTER) 


RACF  and  Online  Interfaces 


To  activate  the  RAGF  interface,  you  must  specify  a  value  for  the  RACF 
initialization  parameter,  then  refer  to  this  table.  Custom  tailoring  of  security 
requirements  can  be  implemented  by  modifying  of  the  appropriate  user  exits: 


Online  interface 

Default  Exits  Provide  Full  RACF  Interface, 
ViaSAF 

Exit$  Used 

Native  TSO 

YES 

SARUSTUX 

SARSECUX 

TSO/cross- 
memory  services 

YES 

RACF  is  activated  by  the  cross-memory 
parameter  LGNSEC.  Default  exits  copy  TSO 
user  signon  and  logon  from  the  SARXMS 
interface. 

E22TSOUX 

SARUSXUX 

SARSECUX 

ISPF 

YES 

SARUSTUX 

SARSECUX 

ISPF/cross- 
memory  services 

YES 

RAGF  is  activated  by  the  cross-memory 
parameter  LGNSEC.  Default  exits  copy  ISPF 
user  signon  and  logon  from  the  SARXMS 
interface. 

E22SPFUX 

SARUSXUX 

SARSECUX 

VM/CMS 

NO 

SARUSVUX 

SARSECUX 

CA-Roscoe 

NO 

SARSECUX 

SARUSRUX 

CA-Roscoe/ cross¬ 
memory 

NO 

RACF  is  activated  by  the  cross-memory 
parameter  LGNSEC.  Default  exits  copy 
CA-Roscoe  user  signon  and  logon  from  the 
SARXMS  interface. 

E22ROSUX 

SARUSXUX 

SARSECUX 

Continued 


kJ 
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Continued 


Online 

Interface 

Default  Exits  Provide  Full  RAGF 
Interface,  Via  SAF 

Exits  Used 

GIGS 

YES 

RAGF  is  activated  by  the  cross-memory 
parameter  LGNSEG.  Default  exits  copy 
GIiCS  user  signon  and  logon  from  the 
SARXMS  interface. 

XMSGIGUX 

SARUSXUX 

SARSEGUX 

Native  VTAM 

YES 

SARUSAUX 

RAGF  is  activated  by  the  cross-memory 
parameter  LGNSEG. 

SARSEGUX 

IMS 

YES 

XMSGIIUX 

Bypassing  Password  Verification 

For  the  following  online  interfaces,  you  can  bypass  password  specification,  and 
allow  a  user  to  log  onto  a  CA-View  database  once  that  user  is  logged  onto  the 
online  interface: 

CICS  pseudo-conversational 
IMS 

ISPP/Cross  memory 
TSO/cross  memory 
ROSCOE/cross  memory 

To  implement  this  functionality,  you  must  do  the  following: 

1.  Specify  LGNSEC=YES  for  the  cross-memory  region  startup  parameter. 

2.  Define  the  SARXMS  region  to  RAGF,  using  the  IGHRIN03  MVS  table. 


After  setting  up  the  SARXMS  region  definition  and  assembling  it  into  the  linklist 
libraries,  the  following  RAGF  commands  should  be  executed  on  TSO/RAGF: 

AG  (PROCGRP)  OnMER(SYSl)  SUPGROUP (SYSl) 

AU  (SAR60)  PASSWORD (PASS)  OWNER ( PROCGRP )  DFLTGRP (PROCGRP) 

You  must  IPL  to  implement  these  changes. 

See  ihe  CA-View  Installation  Guide  for  information  about  the  LGNSEG  parameter. 
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CA-ACF2  Protection 

CA-AGF2  protection  is  available  to  restrict  access  to  individual  SYSOUT  groups 
using  the  CA-ACF2  option.  When  the  CA-ACF2  option  is  specified,  CA-View 
issues  the  CA-ACF2  security  interface  SVC  for  a  SYSOUT  group  before  allowing 
access  to  it  To  browse  a  SYSOUT  group  or  load  it  to  disk,  you  or  the  job  must 
have  input  authority  for  it;  to  print  a  SYSOUT  group,  you  must  have  update 
authority  for  it;  and  to  delete  a  SYSOUT  group,  you  must  have  scratch  authority 
for  it. 

As  with  RACF  protection,  the  entity  for  which  the  CA-AGF2  security  check  is 
made  is  a  "pseudo"  data  set  having  a  name  of  the  form: 

index. id 

(if  the  SYSOUT  ID  is  1  to  8  characters) 
or 

index,  subid-l .  $subid'-2 

(if  the  SYSOUT  ID  exceeds  8  characters) 

where: 

index  Specifies  the  value  specified  widi  the  GA-AGF2  option 

id  Specifies  the  full  SYSOUT  ID 

subid~l  Specifies  characters  1  through  8  of  the  SYSOUT  ID 

subid-2  Specifies  the  remaining  characters  of  the  SYSOUT  ID  beginning 

with  the  ninth  character 

The  CA-ACF2  security  check  is  done  by  data  set  name  only,  meaning  no  volume 
serial  number  is  used. 


CA-ACF2  Example  Assuming  the  initializationiparameter  AGF2=SAR  has  been  specified,  the 

following  data  sets  are  security-checked  by  GA-View  whenever  access  to  the 
specified  SYSOUT  groups  is  requested. 


SYSOUT  ID 

Data  Set  Name 

REPORTX 

VIEW.REPORTX 

PRODJOBR275 

VIEW.PRODJOBR4275 
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Appropriate  data  set  access  rules  must  be  established  by  the  site  for  CA-A(CF2  to 
control  access. 


CA-AGF2  and  Online  Interfaces 

To  activate  the  CA'-ACF2  interface  you  must  specify  a  value  for  the  CA-ACF2 
initialization  parameter,  then  refer  to  this  table.  Custom  tailoring  of  security 
requirements  can  be  implemented  by  modifying  the  appropriate  user  exits: 


Online  Interface 

Defaults  Exits  Provide  Full  CA-ACF2 
Interface,  Via  SAF 

Exits  Used 

Native  TSO 

YES 

SARUSTUX 

SARSECUX 

TSO/cross- 

YES 

E22TSOUX 

memory  services 

CA-ACF2  is  activated  by  the  cross-memory 
parameter  LGNSEG.  Default  exits  copy  TSO 
user  signon  and  logon  from  the  SAR>(MS 
interface. 

SARUSXUX 

SARSECUX 

ISPF 

YES 

SARUSTUX 

SARSECUX 

ISPF/cross- 

YES 

E22SPFUX 

memory  services 

CA-ACF2  is  activated  by  the  cross-memory 
parameter  LGNSEG.  Default  exits  copy  ISPF 
user  signon  and  logon  from  the  SARXMS 
interface. 

SARUSXUX 

SARSECUX 

VM/CMS 

NO 

SARUSVUX 

SARSECUX 

CA-Roscoe 

NO 

SARSECUX 

SARUSRUX 

CA^Roscoe/cross- 

NO 

E22RGSUX 

memory  services 

CA-AGF2  is  activated  by  the  cross-memory 
parameter  LGNSEG.  Default  exits  copy  CA- 
Roscoe  user  signon  and  logon  from  die 
SARXMS  interface. 

SARUSXUX 

SARSECUX 

CIGS 

YES 

XMSCIGUX 

CA-ACF2  is  activated  by  the  cross-memory 
parameter  LGNSEG.  Default  exits  copy 

CIGS  user  signon  and  logon  from  the 
SARXMS  interface. 

SARUSXUX 

SARSECUX 

Continued 
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Online 

Interface 

Default  Exits  Provide  FulllCA-ACF2 
Interface,  Via  SAF 

Exits  Used 

Native  VTAM 

YES 

CA-A<ZF2  is  activated  by  the  cross-memory 
parameter  LGNSEC. 

SARUSAUX 

SARSEGUX 

IMS 

YES 

CA-ACF2  is  activated  by  the  cross-memory 
parameter  LGNSEC.  Default  exits  copy  IMS 
user  signon  and  logon  from  the  SArScMS 
interface. 

XMSCIIUX 

SARSECUX 

SARUSXUX 

Bypassing  Password  Verification 

For  the  following  online  interfaces,  you  can  bypass  password  specification,  and 
allow  a  user  to  log  onto  a  GA-View  database  once  that  user  is  logged  onto  the 
online  interface: 

CICS  pseudo-converseLbxonal 
XHS 

ISPF/cross  memory 
TSO/cxobb  memory 
ROSCOB/cross  memory 

To  implement  this  functmnality,  you  must  do  the  following: 

1.  Specify  LGNSEC=YES  for  the  cross-memory  region  startup  parameter. 

2.  Specify  the  appropriate  SAFPRGT  rules  for  CA-ACF2. 

See  the  CA-View  Installation  Guide  for  information  about  the  LGNSEC  parameter; 
see  the  following  for  sample  SAFPROT  rules  for  CA-ACF2  (additional 
modification  may  be  required  due  to  site  requirements): 


For  the  ISPF  interface: 

SAFPROT. SARI  CLASSEStDATA  SET)  CNTLPTS { SARSPF )  SUBSYS(SVG019) 
SAFPROT. SAR2  CLASSES (DATA  SET)  CNTLPTS (SARSPF)  SUBS YS (SARSPF) 


For  the  VTAM/XMEM  interface: 


SAFPROT.  SAR3  CLASSES  (DATA  SET); 
SAFPROT. SAR4  CLASSES (DATA  SET) 
SAFPROT. SAR5  CLASSES(DATA  SET) 
SAFPROT. SAR6  CLASSES (DATA  SET) 


CNTLPTS  (E22XI1DRV) 
CNTLPTS (E2  2VTDRV) 
CNTLPTS (E22XMDRV) 
CNTLPTS ( E22VTDRV) 


SUBSYS(SVC019) 
SUBSYS(SVC019) 
SUBSYS (E22XMDRV) 
SUBSYS ( E2  2VTDRV) 
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System  Extensions  (SARXTD) 

CA-View  has  been  designed  to  function  without  any  modifications  to  operating 
system  code;  however,  there  are  features  that  are  so  closely  tied  to  the  operating 
system  that  they  could  notbe  implemented  if  the  policy  of  no  system 
modifications  were  strictly  adhered  to.  These  features  are  available  through 
CA-View  system  extensions. 

To  implement  a  system  extensions  feature,  GA-View  "front  ends"  the  appropriate 
operating  system  function  by  dynamically  interfacing  to  the  running  system  (for 
example,  changing  an  address  in  the  SVC  table).  Since  the  change  is  djmamic,  no 
permanent  change  is  ever  made  to  operating  system  code.  There  are  two  major 
benefits  in  choosing  to  implement  the  features  in  this  manner: 

■  The  features  can  be  activated  or  deactivated  at  will. 

■  The  application  of  operating  system  maintenance  is  not  affected  by  CA-View. 

Currently  there  are  only  three  features  that  require  implementation  via  CA-View 
system  extensions: 

■  Security  of  CA-View  data  sets 

■  Automatic  report  archival 

■  Capture  of  job  accounting  data 

If  you  require  any  of  these  features,  you  must  activate  CA-View  system 
extensions  on  each  processor  at  your  site. 

The  system  extension  task  is  not  a  continuously-running  task.  It  only  executes 
long  enough  to  dynamically  interface  to  the  system,  then  it  terminates. 

If  the  data  set  security  feature  of  system  extensions  restricts  access  to  the 
CA-View  LOAD  library,  the  CA-View  LOAD  library  cannot  be  used  in  a 
STEPLIB  or  JOBLIB  DD  statement  of  any  executable  job. 

Neither  the  CHKPT  macro  nor  the  CHKPT=EOV  JCL  statement  can  be  used  with 
SARXTD  alone.  They  must  be  used  in  conjunction  with  GA-Deliver.  See  the 
section  Automatic  Report  Archival  in  Chapter  5,  "Archival,"  for  more 
information. 


Activating  System  Extensions 

To  activate  the  system  extensions  on  a  processor  (or  to  reactivate  those  features 
that  have  been  deactivated),  issue  the  following  command: 

S  SARXTD  [,PABU='parastetez-s'] 
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(  i 


where  parameters  specifies  one  or  more  optional  parameters  used  to  override 
those  in  the  start  procedure  JCL.  See  System  Extensions  Parameters  later  in  this 
chapter. 

Please  note  the  following: 

■  You  should  add  the  S  SARXTD  command  to  member  GOMMNDxx  of 
SYSl.PARMLIB  to  start  the  system  extensions  task  automatically  at  each  IPL. 

■  The  data  set  security  feature  is  activated  only  when  its  parameter  is  specified 
in  the  parameter  field  used  to  start  CA-View  system  extensions. 

■  The  automatic  report  archival  feature  is  activated  only  when  its  parameters 
are  specified  in  the  parameter  field  used  to  start  CA-View  system  extensions. 

■  The  accoimting  data  capture  feature  is  activated  only  when  the  SARACT  DD 
statement  for  the  accounting  file  is  included  in  the  JCL  procedure  used  to 
start  CA-View  system  extensions. 

■  You  can  use  the  following  dummy  DD  statements  in  conjunction  with  the 
SARXTD  program; 

//N0SVG99  DD  DUMMY 

Dynamic  deallocation.  (SVC  99)  of  SYSOLfT  data  sets  is  bypassed  during 
subsystem  close  processing.  This  causes  the  SYSOUT  data  sets  produced  by 
automatic  report  archival  to  be  imavaUable  to  the  CA-View  started  task  imtil 
job  termination.  If  this  DD  statement  is  not  present,  each  report  is  available 
when  it  is  closed,  potentially  causing  a  separate  entry  for  it  in  the  CA-View 
database. 

//MOTEBM  DD  DUMMY 

The  SARXTD  started  task  remains  active  and  responds  to  MODIFY 
commands  as  they  are  received  through  the  operator  console.  Note  that  the 
started  task  terminates,  regardless  of  whether  or  not  this  DD  statement  is 
present,  when  all  system  extensions  have  been  deactivated. 

/  /SUBSYSn  DD  DX}MMY 

More  than  one  set  of  system  extensions  can  be  implemented  concurrently  by 
specifying  a  unique  subsystem  identifier  (n)  in  this  DD  statement. 

If  you  want  to  use  multiple  SARXTDs,  you  must  be  aware  of  die  following: 

■  If  job  accoimting  is  to  be  used  in  a  single  CPU  environment,  accounting 
should  be  done  in  only  one  SARXTD:  If  more  than  one  SARXTD  is  used, 
accounting  data  is  double  posted. 

■  If  job  accounting  is  to  be  used  in  a  multiple-CPU  environment,  the 
accounting  data  set  can  be  shared  only  across  systems  within  the  same  multi¬ 
access  spool  complex.  Furthermore,  SARXTD  will  record  accounting  data 
only  for  jobs  run  on  a  CPU  on  which  you  have  requested  SARXTD 
accounting.  Therefore,  to  record  accounting  data  on  all  CPUs,  you  must  run 
SARXTD  accounting  on  aU  CPUs. 
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■  For  automatic  report  archival,  processing  is  performed  based  on  the 

alphanumeric  order  of  the  subsystem  identifier.  This  means  that  if  SUBSYS2 
and  SUBSYS6  request  automatic  archival  for  the  same  SYSOUT,  only  the 
SUBSYS2  request  is  honored— even  if  SUBSYS2  was  started  after  SUBSYS6. 


Deactivating  System  Extensions 

Occasionally,  you  may  need  perform  maintenance  on  a  CA-View  data  set  (for 
example,  to  reformat  the  accoimting  file).  In  this  instance,  one  or  more  or  alHof 
the  features  of  the  system  extensions  can  be  deactivated  on  a  processor. 

Be  sure  that  security  is  not  compromised  when  the  security  feature  is  deactivated 
on  a  processor.  Also,  be  aware  Aat  when  the  accounting  feature  is  deactivated  on 
a  processor,  no  accounting  data  is  captured  for  jobs  beginning  execution  on  that 
processor. 

The  following  commands  deactivate  CA-View  system  extensions: 


S  SARXTD, PAfiH^OFF 

Deactivates 

S  SARXTD, PARH=OFFSEC 

Deactivates 

S  SARXTD, PARH=OFFARA 

Deactivates 

feature 

S  SARXTD, PARM=OFFACT 

Deactivates 

all  features 

ordy  the  data  set  security  feature 
only  the  automatic  report  archival 

only  the  job  accounting  capture  feature 


System  Extensions  Parameters 

The  parameter  field  on  the  EXEC  statement  in  the  start  procedure  JCL  (or 
specified  as  an  override  on  the  start  command  for  starting  CA-View  system 
extensions)  passes  parameters  for  the  data  set  security  and  automatic  report 
archival  features  of  the  system  extensions. 

The  format  of  the  parameter  field  is: 

PASli='  index,  jobclasa/syaclass/archclass/archdest/arcbform/arclmBdia, 
where: 

index  Specifies  the  high-level  index  (one  or  more  qualifiers  separated  by  periods 
with  a  maximum  length  of  17  characters)  of  the  CA-View  data  sets  for 
which  data  set  security  is  to  be  activated 

If  you  do  not  want  to  activate  the  data  set  security  feature,  you  must  omit 
the  index  from  the  parameter  field  (note  that  index  is  positional  and  its 
absence  must  be  indicated  by  coding  the  coinma  that  follows). 
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Once  the  data  set  security  feature  is  activated,  any  program  (other  than 
CA-View)  that  has  not  been  marked  in  the  program  properties  table  to 
bypass  password  protection  is  restricted  from  accessing  any  data  set 
whose  name  begins  with  the  specified  high-level  index. 

where: 

jobclass/sysclass/archclass/archdest/archform/archmedia 

Specifies  a  set  of  specifications  used  to  select  and  archive  reports  for  the 
automatic  archival:  feature.  You  can  code  up  to  four  sets  of  specifications 
in  the  parameter  field  (indicated  by  the  ellipses).  A  set  of  specifications  is 
comprised  of  six  elements,  each  of  which  is  separated  from  the  next  by  a 
slash  " The  meaning  of  each  element  is  described  as  follows: 

jobclass  Specifies  1  to  8  job  execution  classes  for  which  reports 

are  automatically  archived 

You  can  specify  an  asterisk  to  indicate  all  job  classes. 

sysclass  Specifies  1  to  8  SYSOUT  classes  for  which  reports  are 

to  be  automatically  archived 

You  can  specify  an  asterisk  to  indicate  all  SYSOUT 
classes. 

archclass  You  can  use  the  SYSOUT  class  to  create  an  additional 

SYSOUT  data  set  for  the  report  that  is  spxm-off  for 
archival 

You  can  omit  the  element  or  specify  an  asterisk  to 
indicate  that  the  default  SYSOUT  class  (MSGCLASS 
for  the  job)  is  used  to  create  the  spin-off  data  set. 

archdest  Specifies  the  destination  used  to  create  an  additional 

SYSOUT  data  set  for  the  report  that  is  sp^m^off  for 
archival 

You  can  omit  the  element  or  specify  an  asterisk  to 
use  the  system  default  destination. 

archform  You  can  use  the  forms  name  to  create  an  additional 

SYSOUT  data  set  for  the  report  that  is  spim-off  for 
archival 

You  can  omit  the  element  or  specify  as  an  asterisk  to 
use  the  system  default  forms  name. 
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archmedia  Specifies  the  media  used  to  archive  the  SYSOUT 

Specify  D  to  archive  the  SYSOUT  to  disk,  or  T  to 
archive  the  SYSOUT  directly  to  tape. 

If  omitted,  the  SYSOUT  is  archived  to  disk. 

Note:  You  must  specify  the  combination  of  archclass,  archdest,  and  archform  on 
the  SARDMIT  parameter  CLSL=,  DEST=,  and  FORM=  to  implement  automatic 
report  archival.  For  examples  of  coding  the  automatic  report  archival 
specifications,  see  the  section  Automatic  Report  Archival  in  Chapter  5, 
"Archival" 
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Chapter  4 

Online  Interface  Administration 


In  This  Chapter 

This  chapter  provides  information  about  the  various  online  retrieval  systems 
from  which  CA-View  can  nm  including: 

■  Bringing  up  CA-View  under  a  particular  online  system 

■  CA-View  security  and  online  systems 

This  chapter  also  includes  a  section  about  the  operation  of  the  CA-View  cross¬ 
memory  task,  which  controls  the  following: 

■  CICS  pseudo-conversational  option 

■  VT AM  online  retrieval 

■  IMS  online  retrieval 

■  ISPF/cross-memory 

■  TSO/ cross-memory 

■  CA-Roscoe/cross-memory 


Online  Retrieval  Specifications 

You  can  access  the  online  retrieval  facility  of  CA-View  from  many  different 
terminal  management  systems  (such  as  TSO,  ISPF,  CICS,  and  VM/CMS)  as 
separate  options. 

The  display  screens,  input  commands,  and  selection  codes  used  by  CA-View 
online  retrieval  are  consistent  under  all  online  management  systems.  Exceptions 
are  presented  in  the  following  sections.  In  addition^  these  sections  describe  the 
methods  for  invoking  the  various  oidme  retrieval  options  and  implementation  of 
security. 

You  can  display  the  CA-View  logo  when  entering  the  CA-View  system  using  the 
LOGO  initialization  parameter. 

■  To  access  the  CA-View  Primary  Selection  panel  from  the  CA-View  logo 
screen,  press  ENTER. 
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Native  TSO 


You  invoke  the  native  TSO  online  retrieval  facility  using  the  following  command: 
SARTSO  high- level -name 

where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 

For  example: 

SARTSO  VIEW.SYSTEHl 

To  simplify  the  invocation,  you  can  create  a  CLIST  containing  the  SARTSO 
command. 

See  the  section  Logon  Security  in  Chapter  3,  "Configuring  CA-View,"  for  details 
about  implementation  of  internal  and  external  security. 


TSO/Cross-Memory  Services  Interface 

You  invoke  the  TSO/ cross-memory  services  online  retrieval  facility  using  the 
following  command: 

E22XHTSO  high- level -name 

where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 
For  example: 

E22XHTSO  VZEW.SYSTEHl 

To  simplify  the  invocation,  you  can  create  a  CLIST  containing  the  E22XMTSO 
command. 


ISPF 

In  general,  you  install  the  ISPF  orxline  retrieval  feature  so  that  entering  a  selection 
code  in  one  of  the  option  panels  invokes  CA-View  online  retrieval.  The 
installation  instructions  explain  how  to  set  up  a  selection  code  for  CA-View. 

As  an  alternative,  you  can  invoke  the  ISPF  online  retrieval  facility  from  TSO  with 
the  following  command: 

From  ISPF: 

ISPSTART  PGM(SARSPF)  PMOUhigh-level-name)  IIEWAPPL(SAR) 

where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 
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For  example: 

ISPSTART  PGU(SARSPF)  PARM{VXEW. SYSTEHl)  NEWAPPI.(SAR) 

To  simplify  the  invocation,  you  can  create  a  CLIST  containing  the  ISPF  or 
ISPSTART  command. 

Note:  If  you  are  in  CA-View  split-screen  mode,  the  CA-View  session  must  be  in 
the  top  half  of  the  split  screen  and  at  least  four  lines  must  be  visible. 


ISPF/Cross-Memory  Services 

In  general,  you  install  the  ISPF/cross-memory  services  online  retrieval  feature  so 
that  entering  a  selection  code  in  one  of  the  option  panels  invokes  CA-View  online 
retrievaL  The  installation  instructions  explain  how  to  set  up  a  selection  code  for 
CA-View. 


As  an  alternative,  you  can  invoke  the  ISPF/cross-memory  services  online 
retrieval  facility  from  TSO  with  the  following  commands: 

■  FromSPF: 

ISPF  PGM(E22XMSPF)  FABM{high-level-name) 
m  From  ISPF: 

ISPSTART  PGM(E22XMSPF)  PAKM(lligi-leTrel-najne)  NEWAPPL(SAR) 
where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 
For  example: 

ISPSTART  PGH(E22XHSPF}  PARH(VIEW.SYSTEHl)  IIEWAPPL(SAR) 

To  simplify  the  invocation,  you  can  create  a  CLIST  containing  the  ISPF  or 
ISPSTART  command. 

■  From  VM/ CMS; 

You  invoke  the  VM/CMS  online  retrieval  facility  directly  from  CMS  with  the 
following  command: 

SARCHS  £n  ft  fm 
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where: 


fn  Specifies  the  file  rrame  of  the  parameter  file 

The  parameter  file  is  created  and  initialized  as  part  of  the  installation 
procedure.  If  omitted,  file  name  defaults  to  SARIDX. 

ft  Specifies  the  file  type  of  the  parameter  file 

If  omitted,  file  t5rpe  defaults  to  FILE. 

fin  Specifies  the  file  mode  of  the  parameter  file 

If  omitted,  all  disks  for  the  user  are  searched  for  the  file. 

For  example: 

SARGHS  SARIDX  FILE  A 

To  simplify  the  invocation,  you  can  create  an  EXEC  containing  the  SARCMS 
coimnand. 


CMS  and  VTAM  Printing  and  CA-Spool 

The  CA-View  VTAM  Print  and  GA-Spool  Print  commands  are  not  valid  through 
CMS. 


CA-Roscoe 


You  invoke  the  CA-Roscoe  online  retrieval  facility  directly  from  CA-Roscoe  with 
the  following  command: 

CALL  SARROS  ' bigh-level-name' 

where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 

For  example: 

CALL  SARROS  'VIEW.SYSTEMl' 

To  simplify  the  invocation^  you  cam  create  an  RPF  containing  the  CALL 
command. 


CA-Roscoe/Cross-Memory  Services 

You  invoke  the  CA-Roscoe  online  retrieval  facility  directly  from  CA-Roscoe  with 
the  following  command: 

CALL  E22XHROS  'high- level -namB' 

u 


4-4  CA-View  System  Reference  Guide 


Online  Retrieval  Specifications 


where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 
For  example: 

GALL  E22XUROS  'VZEH.SYSTEHl' 

To  simplify  the  invocation,  you  can  create  an  RPF  containing  the  CALL 
command; 


CICS  (Cross-Memory) 

You  invoke  the  CICS  online  retrieval  facility  from  CICS  by  entering  a  predefined 
transaction  identifier.  The  transaction  identifier  is  established  as  part  of  the 
installation  instructions. 

Alternatively,  you  can  invoke  CA-View  from  a  user-written  CICS  menu  system. 
See  the  section  Installing  the  CICS  Pseudo-Conversational  Option  in  the  CA-View 
Installation  Guide  for  more  information. 


Native  VTAM 


In  general,  you  install  the  native  VTAM  online  retrieval  feature  so  that  it  requires 
only  a  one- word  command  to  log  onto  CA-View  online  retrieval.  The  installation 
instructions  explain  how  to  set  up  this  command  to  VTAM.  Alternatively,  you 
can  use  the  standard  VTAM  LOGON  command  to  invoke  CA-View  online 
retrieval  as  follows: 

LOGON  APFLID(SARVTAH)  DATA(lligh-Ievel-naine) 

where  high-level-name  specifies  the  high-level  name  of  the  CA-View  database. 

For  example: 

LOGON  APPLID(SARVTAM)  DATA (VIEW. SYSTEMl) 

With  the  logon  format  cross-memory  parameter  (LGNFMT),  you  can  specify  the 
logon  data  that  you  expect.  See  the  CA-View  Installation  Guide  for  more 
information  about  the  parameter. 


IMS  Online  Interface  Transaction  Specification 

Start  SARJQMS  (a  cross-memory  service  task).  The  IMS/DC  transaction  program 
is  conversational  and  starts  when  you  enter  the  IMS/DC  transaction  and  terminal 

type- 
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Use  the  following  table: 


Transaction 

Terminal  Type 

M2 

3278-224  X  80  Default  screen  size 

M2H 

3278-224  x  80  HighUghting 

M2X 

3279-224  x  80  COLOR  Highlighting 

M2C 

3279-224  x  80  COLOR 

M3 

3278-332  x  80 

M3H 

3278-332  X  80  HighUghting 

M3X 

3279-332  x  80  COLOR  HighUghting 

M3e 

3279-332  x  80  COLOR 

M4 

3278-443  X  80  HighUghting 

M4H 

3278-443  x  80  HighUghting 

M4X 

3279-443  x  80  COLOR  HighUghting 

M4C 

3279-443  x  80  COLOR 

M5 

3278-527x132 

M5H 

3278-527  x  132  HighUghting 

M5X 

3279-527  x  132  COLOR  HighUghting 

M5C 

3279-527x132  COLOR 

M6 

329062  X  80 

M6H 

329062  X  80  Hijghlighting 

M7 

329031  X 160 

M7H 

329031  X  160  HighUghting 

M8 

329062x160 

M8 

329062  X 160  HighUghting 

CA-View  VTAM  print  is  not  valid  through  IMS  Online. 
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Operating  the  Cross-Memory  Task 

The  cross-memory  task  executes  as  the  application  for  the  cross-memory  online 
retrieval  option  and  is  used  for  the  following: 

■  The  CICS  pseudo-conversational  option 

■  VTAM  online  retrieval 

■  IMS  online  retrieval 

■  ISPF /cross-memory 

■  TSO/ cross-memory 

■  CA-Roscoe/cross-memoiy 

The  standard  procedure  for  the  cross-memory  task  is  located  in  CAI.PPOPTION. 


Starting  the  Cross-Memory  Task  (START) 

The  cross-memory  task  is  started  with  the  following  operator  command: 

S  SAKXMS 

The  PARM  field  in  the  SARJQvlS  PROC  specifies  an  eight-character  internal  name 
for  the  system,  the  maximum  number  of  users  allowed,  the  transaction  timeout 
limit,  and  a  Cancel  Cormection  field. 


Immediate  Termination  (SHUTDOWN) 

'  The  cross-memory  task  is  immediately  terminated  with  the  operator  command: 

F  SARXHS, SHUTDOWN 

This  command  immediately  terminates  all  active  user  sessions. 


Normal  Termination  (QUIESCE) 

A  QUIESCE  command  causes  termination  of  the  cross-memory  task  when  the 
last  user  ends  his  or  her  session.  If  no  users  are  in  session  when  the  cross-memory 
online  task  is  quiesced,  the  task  terminates  immediately. 


o 
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The  cross-memory  task  is  quiesced  with  the  operator  command;: 
F  SABXHS, QUIESCE 

or 

P  SARXHS 


Canceling  Users  (CANCEL) 

Users  are  canceled  from  the  cross-memory  task  by  the  operator  command: 


[ALL] 

F  SASXHS, CANCEL  [COHXD=] 
[UID#=] 
tUSERID=] 
[SASDB=] 
[BHODB=] 
[INBDB=] 


where: 


Cancels  all  users 


CANCEL  ALL 

CANCEL  CONlD='connectidT 

/connectidl' 

connectidN'< 


CANCEL  Ul]D#=nnn,nnn,nnn 


Cancels  a  specific  user  using  the  20- 
character  connect-ID 

A  user's  connect-ID  is  displayed  with 
the  LIST  command. 

Cancels  a  specific  user  using  control 
block  number 


A  user's  control  block  number  is  listed 
with  the  LIST  command. 

CANCEL  USERID=Msendl,  Cancels  a  specific  user  by  CA-View 
useridZ, userids  user  ID 


CANCEL 

SAKDB=database.mtne 

CANCEL 

BMODB=database.name 
CANCEL  INBDB=Zseruid 


Cancels  all  users  accessing  this 
CA-View  database 

Cancels  all  users  accessing  this 
CA-Deliver  database 

Cancels  all  users  accessing  this 
CA-Balancing  database 
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Suspending  Additional  Logons  (SUSPEND) 

Additional  user  logons  are  suspended  from  cross-memory  tasks  using  the 
operator  command: 

F  SABXMS,  SUSPEND  {ADD ]  SAB.VTAH  |  SHOVTAU  |  XHS  |  VTAM  |  SAEDB= 

!USODB= I 1NBDB=} 

You  can  SUSPEND  ALL,  SARVTAM,  RMOVTAM,  XMS,  or  VTAM  (both 
SARVTAM  and  RMOVTAM)  tasks. 

If  the  VTAMPASS  mitialization  parameter  is  set  to  YES,  the  VTAM  interface 
attempts  to  pass  the  user  to  another  task. 

You  can  also  stop  logons  to  a  particular  CA-View,  CA-Deliver,  or  GA-Balancing 
database  with  the  SARDB=,  RMODB=,  and  INBDB=  parameters.  If  no  users  are 
logged  on  to  the  database,  it  is  de-allocated  from  the  cross-memory  region. 


Resuming  Acceptance  of  New  Logons  (RESUME) 

The  acceptance  of  new  logons  to  the  cross-memory  task  is  resumed  by  the 
operator  command: 

F  SAHXMS,  RESUME  {ADD  |  SARVITAM  |  RMOVTAM  |  INBVTAM  |  XMS  |  VTAM 
SARDB= I RHODBs | INBDB= } 

You  can  RESUME  ALL,  SARVTAM>  RMOVTAM,  INBVTAM,  VTAM  (aU 
VTAMs),  or  XMS  tasks. 

You  can  also  resxime  acceptance  of  logons  to  a  particular  CA-View,  CA-Deliver, 
or  CA-Balancing  database  with  the  SARDB=,  RMODB=,  and  INBDB= 
parameters. 


Closing  Cross-Memory  Tasks  (CLOSE) 

The  CLOSE  command  closes  the  VTAM  ACB  and  users  are  immediately 
terminated.  Logons  are  not  accepted  until  an  OPEN  command  is  issued,  re¬ 
opening  the  VTAM  ACB;  CLOSE  overrides  the  VTAMPASS  parameter  in  that 
users  attempting  to  sign  on  are  not  passed  to  another  cross-memory  task.  The 
command  is: 

F  SARXHS,CDOSE  {ADD]  SARVTAM |  RMOVTAM]  INBVTAn|  VTAM} 

You  can  CLOSE  ALL,  SARVTAM,  RMOVTAM,  INBVTAM>  VTAM  (aU  VTAMs), 
or  XMS  tasks. 
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Reopening  Cross-Memory  Tasks  (OPEN) 

The  OPEN  command  re-opens  the  AGB  for  the  VTAM  interface  after  a  CLOSE 
command  has  been  issued.  The  command  is: 

F  SARXMS,OPEN  {ALL  |  SAilVTAM  |  RMOVTAM  |  INBVTAM |  VTAM} 

You  can  OPEN  ALL,  SARVTAM,  mOVTAM,  INBVTAM,  WAM  (aU  VTAMs), 
or  XMS  tasks. 


Listing  Statistics  (LIST) 


A  listing  of  information  relating  to  the  cross-memory  sessions  is  obtained  by  the 
operator  command: 

[DATABASE] 

[ STATUS ] 

[USERS] 

F  SABXHS,LIST  [USES1D=] 

[UID#=] 

[CONID=] 

[SABDB=] 

[BHODB=] 

[INBDB=] 


where: 

LIST  DATABASE!, ALL) 

Displays  the  cross-memory  system  status  and 
active  databases  for  this  task;  ALL  for  all  tasks 

LIST  STATUS{,ALL} 

Displays  the  cross-memory  system  status  of  this 
task;  ALL  for  all  tasks 

LIST  USERS{,ALL  i  ,AGTIVE  1 
,INACTIVE} 

Displays  the  status  of  ALL,  ACTIVE,  or 
INACTIVE  users 

The  default  is  ACTIVE. 

LIST  USERID='Msendr, 
'userid!'  r'useridS' 

Displays  the  status  of  a  specific  user;  identified 
by  CA-View  user  ID 

LIST  \JlD#=nnn,nnn,nnn 

Displays  the  status  of  a  specific  user,  identified 
by  control  block  number 

LIST  CONID= 'connecffdl', 
'connectid! ' ,  'connectidS ' 

Displays  the  status  of  a  specific  user;  identified 
by  the  2G-character  cormect-ID 

LIST  SAKDB=databasename 

Displays  all  user  sessions  using  the  specified 

C A-V iew  database 

LIST  BMODB^databasename 

Displays  all  user  sessions  using  the  specified 
CA-Deliver  database 

LIST  JNBDB=lservid 

Displays  all  user  sessions  using  the  specified 
CA-Balancing  database 
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Changing  Cross-Memory  Parameters  Online  (CHANGE) 

You  can  use  the  CHANGE  command  to  modify  the  following  cross-memory 
initialization  parameters  online: 

C2UICEL 

LONGN&IT 

USEBUAX 

VTAMPASS 


Important!  You  cannot  increase  USERMAX  above  the  value  it  had  when  SARXMS 
was  started,  or  set  VTAMPASS  from  NO  to  YES;  the  region  must  be  recycled. 

■  To  change  the  USERMAX  parameter,  enter  the  following: 

F  SABXHS, CHANGE  nSERMA3C=nnn 


Defining  Muitipie  VTAM  Cross-Memory  Regions 

The  CA-View  Installation  Guide  contains  the  steps  you  need  to  follow  to  install  the 
cross-memory  task.  (VTAM  orUine  retrieval nms  under  the  cross-memory  task.) 
The  following  guidelines  define  multiple  VTAM/ Cross-memory  regions. 


Regions  Grouped  by  MVS  Subsystem  Name 

Multiple  VTAM  regions  are  grouped  under  a  foiur-character  MVS  subsystem 
name.  The  SUBSYS=  cross-memory  parameter  specifies  the  subsystem  name  at 
the  startup  time  of  the  cross-memory  region.  Unless  you  specifically  want  to 
define  separate  multiple  groups  of  VTAM  regions,  you  should  use  the  default 
SUBSYS  parameter.  If  you  specify  SUBSYS=,  all  VTAM  regions  grouped  under 
the  same  SUBSYS  mustbe  started  with  the  same  release/PTF  level  of  the 
CA-View  loadlibs. 


Warningl  If  \  ou  hange  \  our  rclca'-i  nt  C  V-\  itw  me  \  ou  '•p*  «.ifii  J  i  .  ilu«. 
in  ST  BS'irS=  \  ou  must  change  Ihe  SUBS  r '>=  memorv  pai  imtter  cinU 
Ill  toproM-nlt  SA  damage  Ihccontiol block si/ts for  C  i  \kv  an  n.lc-'si 
pendent  and  i an  ^  ruse  si  i  jous  p'robk  m®  f  v i  u  dor  t  -.pet. if\  tlie  <.  oj  r«  1 1 
rUcase  It  \ou  use  tJu  delciLiit  paramLlLi  Joi  SL  BS'^S  \oli  won'thoL  thi-. 
priibkm  because  ea^h  roloasL  of  C  kw  Ji  taull-.  to  the  ayproj  n  it«. 


Online  Interface  Administration  4-1 1 


Defining  MultipleA/TAM  Cross-Memory  Regions 


Regions  Separated  by  REGIONIDs  and  APPLID 


Each  separate  VTAM  region  attached  to  a  SUBSYS  must  have  a  unique 
REGIONID.  You  must  specify  the  REGIONIE)  as  the  first  parameter  of  the 
PARM=  statement  in  the  start  procedure  JCL  for  the  cross-memory  online 
retrieval  task.  A  region  doesn't  start  if  another  region  with  the  same  REGIONID 
is  already  running  for  the  same  SUBSYS. 

Each  separate  VTAM  region  attached  to  a  SUBSYS  must  have  a  unique  VTAM 
APPLID.  The  USSTAB  (defined  in  Step  2  of  Installing  the  VTAM  Online  Retrieval 
Option  in  the  CA-Viero  Installation  Guide)  or  your  session  manager  should  pass  aU 
VTAM  logon  requests  to  the  Primary  VTAM  APPLID.  CArView  re-routes 
requests  to  other  regions  if  the  Primary  is  full  or  marked  as  unavailable.  Each 
VTAM  APPLID  must  have  AUTH=(ACQ,PASS)  and  you  must  specify  the  cross¬ 
memory  parameter  VTAMPASS=YES  for  all  of  the  regions. 


Checking  the  Status  of  Multiple  Regions 


You  can  enter  the  LIST  STATUS  operator  command  with  the  ALL  parameter  to 
display  the  status  of  all  regions  in  the  same  SUBSYS  group.  The  command  is  as 
follows: 

F  SARXMS,LIST  STATUS, ALL 


Specifying  the  Parameters:  SYSIN  Statements 

You  should  specify  as  many  of  the  parameters  as  possible  with  SYSIN  statements 
to  easily  manage  multiple  regions. 

The  REGION  parameter  is  positional  and  must  be  specified  in  the  PARM= 
statement  of  the  cross-memory  task  JGL.  You  should  specify  the  following 
parameters  in  the  PARM=  statement; 

SUBSYS= 

SARAFFL= 

XHS= 


You  can  specify  the  rest  of  the  parameters  with  SYSIN  DD  statements.  If  you 
place  the  SYSIN  statements  m  a  PDS  member,  you  can  alter  the  parameters 
without  shutting  down  the  cross-memory  region;  however,  the  parameters  do  not 
take  effect  imtil  the  next  time  the  region  is  shut  down  and  restarted. 
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Chapter  5 
Archival 


In  This  Chapter 

This  chapter  provides  information  about  the  following: 

■  SYSOUT  archival 

■  AFP  and  Xerox  (XPDS)  report  archival 

■  Exceptional  condition  checking 

■  Operating  the  archival  task 

■  Operating  the  optical migration  subtask 

■  Running  multiple  archival  tasks 

■  Automatic  report  archival 

■  Batch  job  execution  of  the  archival  task 


Archival  of  SYSOUT  Using  the  SARSTC  Started  Task 

Archival  of  SYSOUT  is  performed  by  the  started  task  SARSTC.  SARSTC  is 
normally  started  at  system  IPL  time  and  remains  active  imtil  the  operating 
system  is  brought  down.  SARSTC  uses  the  standard  subsystem  interface  to  JES2 
or  JESS  to  request  SYSOUT  for  archival,  and  it  remains  in  a  wait  state  during  the 
periods  when  no  SYSOUT  is  available  for  archival. 


Archival  Selection  Criteria 

The  initialization  parameters  shown  in  the  following  table  are  available  for 
specifying  the  criteria  used  for  selecting  SYSOUT  for  archival. 
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Parameter 

Description 

CLSL 

A  character  string  made  up  of  one  to 

eight  SYSOUT  classes 

DEST 

Destination 

FORM 

Forms  name 

You  can  specify  each  parameter.  If  you  specify  more  than  one  parameter,  the 
SYSOUT  must  meet  all  the  specifications  for  it  to  be  archived. 

For  example,  suppose  you  specify  MSGCli.ASS=P  on  the  job  statements  for  all 
production  jobs  at  your  site,  and  the  reports  produced  by  the  jobs  are  output  to 
SYSOUT  classes  C,  D,  E,  F,  and  G.  To  archive  the  production  JGL  listings,  you 
would  specify: 

CljSl.=P 

To  archive  the  production  reports,  you  would  specify: 

GLSIi=CDEFG 

If  you  wanted  to  archive  oiUy  production  reports  destined  to  be  printed  at  remote 
10,  you  would  specify: 

Ct^SIisCDEFG 

DEST=RMT10 

CA-View  receives  its  SYSOUT  from  JES  similar  to  that  of  a  printer.  If  a  printer  is 
set  with  the  same  attributes  as  CA-View's  archival  criteria,  the  printer  and 
CA-View  compete  for  SYSOUT  from  JES.  Therefore,  you  must  ensure  that  none 
of  your  printers  is  set  to  CA-View's  archival  criteria;  otherwise,  some  of  your 
SYSOUT  will  be  printed  directly,  rather  than  passed  to  CA-View  for  archival. 


Record  Length 


Logical  records  for  reports  processed  by  CA-View  cannot  exceed  32752  for  fixed- 
length  records  or  32756  for  variable-length  records.  This  includes  the  carriage 
control  character. 
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Method  of  Operation  and  the  Backup  Cycle 

The  CA-View  archival  started  task  receives  SYSOUT  from  the  job  entry 
subsystem  using  the  process  SYSOUT  interface.  This  method  is  the  same  as  that 
used  by  an  external  writer  to  obtain  SYSOUT.  CA-View  receives  SYSOUT  from 
JES,  writes  it  out  as  its  current  disk  generation  to  its  database,  and  records  its 
location  and  characteristics  in  a  master  index  which  also  resides  in  its  database. 
At  specified  intervals  it  automatically  performs  a  backup  cycle  while  continuing 
to  archive  SYSOUT.  Two  t5^es  of  backup  cycles  can  be  performed: 

■  Standard  backup 

■  Interim  backup 

The  standard  backup  cycle  causes  the  current  generation  number  to  be  incremented 
by  one,  so  that  archival  of  SYSOUT  continues  to  a  new  generation; 

The  interim  backup  cycle  does  not  increment  the  generation  number  or  start  the 
microfiche  task.  After  an  interim  backup,  archival  of  SYSOUT  continues  to  the 
same  generation. 

Both  types  of  backup  cycles  are  asynchronous,  that  is,  the  backup  cycle  executes 
concurrently  with  archival  of  SYSOUT. 

The  backup  cycle  consists  of  the  following: 

■  Creating  a  new  current  generation  (standard  backup  only) 

■  Backing  up  SYSOUT  not  currently  on  tape  media 

■  Purging  entries  for  "old"  SYSOUT  from  the  master  index 

■  Cleaning  up  and  recovering  space  for  SYSOUT  groups  that  are  migrating  to 
tape  status,  were  temporarily  loaded  to  disk,  or  were  actively  being  created 
prior  to  a  system  crash  or  abend 

■  Backing  up  the  master  index  to  tape 

■  Updating  the  CA-View  recovery  file 

■  Un-cataloging  tape  data  sets  no  longer  required 

■  Starting  the  microfiche  task  (standard  backup  only) 

In  addition  to  the  automatic  initiation  of  the  backup  cycle  by  CA-View,  you  can 
initiate  a  backup  cycle  at  any  time  using  the  operator  commands.- 


CA-View  Reports 


The  SRBKLST  DD  statement  prompts  CA-View  to  automatically  create  a  report 
listing  of  all  backed  up  files  after  each  archival  of  the  primary  disk. 
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The  following  is  an  example  of  a  SARBKLST  report: 


SARBKLST 

CA-VIEW  (2. 

0)  -  SYSTEM 

ARCHIVAL  TASK 

PAGE  1 

02/28/96  18:37:46  SEQ=00047  VOL= 

=42811$ 

DPLX=*NONE*  BACKUP  LIST 

SGP=DEFAULT  DSN=VIEW . SYSTEMl . SARTAPE .0000047 

ID  JOB  NAME  JOBID  GEN 

SEQ 

ARC  DATE  ARC  TIME 

LOC 

LINES 

PAGES  DASD 

BLKS 

XCODE 

FILE 

TIME 

REPORTl  COOCH03B  JOB01396  25 

12 

02/28/96  17:29:42 

DISK 

12600 

200 

265 

1 

18:37:46 

REPORTl  COOCH03B  JOB01395  25 

11 

02/28/96  17:29:39 

DISK 

12600 

200 

265 

2 

18:37:48 

REPORTl  COOCH03B  JOB01394  25 

10 

02/28/96  17:29:35 

DISK 

12600 

200 

265 

3 

18:37:49 

REPORTl  COOCH03B  JOB01392  25 

9 

02/28/96  17:29:32 

DISK 

12600 

200 

265 

4 

18:37:51 

REPORTl  COOCH03B  JOB01391  25 

8 

02/28/96  17:29:28 

DISK 

12600 

200 

265 

5 

18:37:52 

REPORTl  COOCH03B  JOB01187  25 

3 

02/17/96  16:17:45 

DISK 

12600 

200 

265 

6 

18:37:54 

TOTAL  REPORTS  BACKED  UP  TO  TAPE 

6 

SARBKLST 

CA-VIEW  (2.0)  - 

SYSTEM  ARCHIVAL  TASK 

PAGE  2 

02/28/96  18:37:56  REPORTS  AND  RESOURCE  GROUPS  DELETED  DURING  STANDARD  BACKUP  OF  GEN 

26 

ID  JOB  NAME  JOBID  GEN 

SEQ 

ARC  DATE  ARC  TIME 

LOC 

LINES 

PAGES  DASD 

BLKS 

XCODE 

FILE 

TIME 

D68D50AE  ShKFSSCC  STC01203  *DVS 

RSRC* 

02/17/96  17:44:11 

227 

70 

1 

18:37:56 

F268B50C  SARFSSCC  STC03326  *DVS 

RSRC* 

02/20/96  15:57:30 

157 

47 

2 

18:37:56 

779AA128  SARFSSCC  STC01181  *DVS 

RSRC* 

02/17/96  15:58:42 

100 

23 

1 

18:37:56 

TOTAL  REPORTS  AND  RESOURCE  GROUPS  DELETED  =  3 

SARBKLST 

CArVIEW  (2.0)  - 

SYSTEM  ARCHIVAL  TASK 

PAGE  3 

02/28/96  18:37:56  SEQ=00047  VOL= 

=428119 

DPLXe*NONE*  BACKUP  LIST 

SGP=DEFAULT  DSN=VIEW .  SYSTEMl .  SARTAPE.  0000047 

MASTER  INDEX  BACKED  UP  AT  FILE 

7 

ON  VOL  428119 

SARBKLST 

CA-VIEW  (2.0)  - 

SYSTEM 

ARCHIVAL  TASK 

PAGE  4 

02/28/96  18:37:59  TAPES  UNCATALOGUED 

DURING  STANDARD  BACKUP  OF 

GEN 

26 

TAPE  DATASET  NAME 

VOLSER 

VIEW.SYSTEMl.  SARTAPE .T0000021 

434675 

VIEW.  SYSTEMl.  SARTAPE. T0000022 

410838 

VIEW .  SYSTEMl .  SARTAPE .  TO  0  0  0023 

434804 

VIEW .  SYSTEMl , SARTAPE . TO  0  0  00  2  5 

413175 

VIEW . SYSTEMl . SARTAPE . TO  0  0  0  0  2  6 

433066 

VIEW . SYSTEMl . SARTAPE .T0000027 

425245 

VIEW . SYSTEMl , SARTAPE . TO  0  0  003 1 

483693 

VIEW .  SYSTEMl . SARTAPE . TO  0  0  003  2 

484218 

VIEW . SYSTEMl . SARTAPE . TO  0  0  00  3  3 

482487 

VIEW . SYSTEMl . SARTAPE . TO  0  0  0  0  3  4 

482060 

VIEW, SYSTEMl . SARTAPE. T0000039 

460308 

VIEW .  SYSTEMl ,  SARTAPE .  T000004  0 

478871 

Archival  and  Database  Space 

If  CA-View  runs  out  of  space  in  its  database  while  archiving  SYSOUT,  it  prompts 
the  operator  for  a  recovery  option.  The  operator  can: 

■  Add  additional  space  to  the  GA-View  database  while  the  archival  task  waits, 
then  request  the  archival  task  to  retry 

■  Request  the  archival  task  to  perform  its  standard  backup  cycle  and  then  retry 

■  Request  the  archival  task  to  terminate 
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Archival  Generations 


The  time  interval  during  which  CA-View  logically  archives  SYSOUT  in  a  group 
for  reference  purposes  is  defined  as  a  generation.  A  generation  can  also  be 
defined  as  the  period  of  time  from  one  standard  backup  cycle  to  the  next,  since  it 
is  the  backup  cycle  that  creates  a  new  generation.  The  site  has  complete  control 
over  the  beginning  and  length  of  time  of  the  generation  with  the  TIME  and 
INTERVAL  initialization  parameters.  For  most  sites,  the  interval  is  24  hours  and 
comprises  the  site's  daily  productioni  cycle. 

Note:  You  can  perform  interim  backups  by  specifying  the  NBACKUP 
initialization  parameter.  Automatic  interim  backups  are  dependent  on  the 
standard  backup.  If  no  standard  backup  is  performed,  TBACKUP=NO,  or 
DAYS=NNNNT^,  no  interim  backups  are  performed. 

You  can  suppress  a  backup  cycle  for  any  day  of  the  week  with  the  DAYS 
initialization  parameter.  For  example,  assume  that  the  site  is  "closed"  on 
Simdays,  with  no  operator  on  hand  to  moimt  tapes  for  the  backup  cycle.  In  this 
case,  the  site  suppresses  the  automatic  backup  cycle  on  Sundays  by  setting 
DAYS=YYYYYYN. 


You  use  the  NGEND  and  NGENT  initialization  parameters,  respectively,  to 
^  specify  the  number  of  generations  of  SYSOUT  maintained  on  disk  and  4ie 

number  maintained  on  tape.  For  example,  to  keep  three  generations  of  SYSOUT 
on  disk  and  90  generations  on  tape,  specify: 

NGEND-3 

N6ENT=90 


In  this  example,  90  total  generations  are  retained  by  CA-View.  Immediately  after 
a  job  runs,  three  generations  of  thie  job  are  on  disk.  The  most  recent  generation 
resides  on  disk  only  and  die  next  two  generations  reside  both  on  disk  and  tape. 
The  remaining  87  generations  reside  on  tape  only.  Immediately  after  a  standard 
backup  cycle,  only  the  two  most  recent  generations  reside  on  disk  and  tape;  the 
remaining  87  generations  reside  on  tape  only.  The  NGENT  value  includes  the 
NGEND  value. 


Direct-to-Tape  Archival 

For  large  reports,  or  other  SYSOUT  for  which  the  site  does  not  require  immediate 
access  but  for  which  archival  is  desired,  the  site  can  define  from  one  to  eight 
classes  to  be  archived  directly  to  tape.  The  initialization  parameter  used  to  define 
direct-to-tape  archival  classes  is  TAPECLSL. 


I 
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For  example,  if  you  want  to  archive  aU  SYSOUT  with  a  form  name  of  VIEW  and, 
of  the  SYSOUT  that  is  archived,  you  want  any  class  T  or  U  SYSOUT  archived 
directly  to  tape  with  no  disk  storage  being  used,  you  would  specify  the  following 
parameters: 

POBM=VlEW 

T&PECLSL=TU 


Due  to  the  sequential  nature  of  tape,  some  restrictions  exist  for  SYSOUT  archived 
directly  to  tape.  These  restrictions  are: 

■  Exceptional  conditions  do  not  cause  the  automatic  printing  of  the  SYSOUT 

■  The  SYSOUT  is  not  processed  by  the  microfiche  started  task 

For  performance  reasons,  once  a  SYSOUT  data  set  is  selected  for  archival,  a  tape 
drive  is  allocated  and  remains  allocated  through  the  next  backup  cycle  or  until 
the  archival  task  is  stopped.  Alternatively,  you  can  specify  the  UNLOAD 
initialization  parameter  to  cause  the  tape  drive  to  be  unloaded  and  freed  after 
each  SYSOUT  group  is  archived  to  tape. 

Note:  If  SYSOUT  is  being  archived  to  tape  when  a  backup  cycle  is  initiated, 
archiving  is  suspended  imtil  the  backup  has  been  completed. 

All  direct-to-tape  SYSOUT  is  written  to  STORGRPO,  the  default  tape  storage 
group.  If  you  specify  a  group  other  than  STORGRPO  for  the  SYSOUT,  that  group 
is  honored  by  the  consolidation  program  SARPAC  when  it  processes  the  tape. 


No  Archival  Option 

CA-View  can  process  SYSOUT  without  actually  archiving  it  to  any  disk  or  tape 
file.  A  site  can  choose  to  use  this  facility  for  certain  classes  of  SYSOUT  in  order  to 
take  advantage  of  the  user  exits  available  with  CA-View.  For  example,  if  a  site 
desires  to  create  special  banner  pages  for  its  SYSOUT  with  CA-View,  even 
SYSOUT  for  which  no  archival  is  desired  could  still  have  the  special  banner 
pages  produced. 

The  site  can  specify  from  one  to  eight  SYSOUT  classes  for  which  no  archival  is 
done  with  the  NARCCLSL  initialization  parameter.  The  same  two  restrictions 
listed  for  direct-to-tape  archival  also  apply  to  the  no  archival  option. 


Exceptional  Condition  Processing 

During  SYSOUT  processing,  CA-View  scans  for  exceptional  conditions.  The  type 
of  conditions  that  are  treated  as  exceptions  are  specified  in  a  table  of  control 
statements  to  the  archival  started  task.  This  table  can  be  updated  and  refreshed 
while  CA-View  is  executing  through  an  operator  command.  User  exit 
SARSTCUX  can  also  be  used  to  specify  exceptional  conditions. 
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The  ROUT,  DESC,  and  XPRINT  parameters  specify  tine  action  CA-View  takes 
whenever  an  exceptional  condition  occurs.  CA-View  issues  a  message  to  the 
operator  identifying  the  exceptional  condition  when  a  non-zero  route  code  is 
specified.  The  ROUT  and  DESC  operands  specify  the  route  and  descriptor  codes, 
respectively. 


XPRESrr=YES  causes  the  SYSOUT  to  automatically  print  whenever  an 
exceptional  condition  occurs.  CA-View  dynamically  allocates  a  SYSOUT  data  set. 

The  default  exceptional  conditions  for  which  CA-View  checks  are: 

■  Non-zero  condition  code 

■  System  or  user  abend 

■  JCL  error 

■  Data  set  cataloging  error 

■  Data  set  not  deleted  error 

■  Operator  cancel  of  allocation  request 

CA-View  may  also  check  for  a  user-specified  text  string  as  an  exceptional 
condition  in  liie  SYSOUT. 


The  conditions  can  be  modified  using  control  statements  specified  earlier  in  this 
section. 


Printing  SYSOUT 


You  can  specify  one  to  eight  classes  of  SYSOUT  for  automatic  printing  at  time  of 
archival  using  the  PRTCLSL  initialization  parameter.  Any  SYSOUT  group  that  is 
being  archived  whose  class  matches  one  of  the  classes  specified  with  the 
PRTCLSL  initialization  parameter  is  written  back  out  to  SYSOUT  by  CA-View. 

When  printing  SYSOUT,  either  because  its  class  matches  one  of  the  PRTCLSL 
classes  or  because  XPRINT=YES  is  specified  and  an  exceptional  condition  occurs, 
CA-View  dynamically  allocates  a  SYSOUT  data  set  and  writes  the  archived 
SYSOUT  to  it.  The  original  class,  destination,  and  form  attributes  can  be 
overridden  by  NEWCLSL,  NEWDEST,  and  NEWFORM  parameters,  respectively. 
All  other  attributes  remain  the  same. 


Archival  of  JCL  Listings 

The  key  to  archiving  JCL  listings  (including  the  job  log  and  allocation  messages) 
is  in  separating  the  JCL  listing  SYSOUT  from  the  report  SYSOUT  produced  by  a 
job  based  on  one  or  more  of  the  following  archival  selection  criteria:  class, 
destination,  and  forms  name. 
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This  separation  can  be  accomplished  in  several  ways,  including: 

■  Assigning  a  different  SYSOUT  class  in  the  MSGCLASS  JOB  statement 
parameter  from  those  classes  specified  in  the  SYSOUT  DD  statements  for  the 
jobs 

■  Assigning  a  special  forms  name  or  destination  to  the  JCL  listings  for  a  job 
with  the  "/^OUTPUT  SYS"  JES2  control  statement 

■  Assigning  a  special  forms  name  or  destination  to  the  JCL  listings  for  a  job 
with  the  "/ /^FORMAT  PR"  JESS  control  statement  for  DD  names:  SYSMSG, 
JESJCL,andJESMSG 

■  Assigning  a  special  forms  name,  destination,  or  SYSOUT  class  to  the  JCL 
listings  for  a  job  with  the  "//  name  OUTPUT  JESDS=ALL"  JCL  statement 

If  you  want  to  archive  some  or  all  of  the  report  SYSOUT  for  a  job  and  its  JCL 

listing,  ensure  that  the  SYSOUT  attributes  of  the  DD  statements  you  want  to 

archive  match  those  of  the  JCL  listing. 


Archival  of  Report  SYSOUT 

This  guide  refers  to  any  SYSOUT  produced  for  a  job  using  DD  statements  (bothi 
those  contained  in  the  JCL  and  those  dynamically  allocated)  is  called  report 
SYSOUT.  Report  SYSOUT  can  be  handled  directly  by  CA-View  as  with  the  JCL 
listings,  or  indirectly  by  archiving  a  copy  of  the  report  SYSOUT  that  has  been 
produced  by  the  automatic  report  archival  feature  of  CA-View  system 
extensions.  Whether  you  choose  to  archive  reports  directly  with  CA-View  or 
indirectly  using  the  automatic  report  archival  feature  depends  primarily  on  your 
need  to  print  the  reports  and/or  track  the  reports  under  JES. 

Direct  archival  of  reports  with  CA-View  is  the  easiest  and  most  straightforward 
approach.  You  specify  the  archival  selection  criteria  to  CA-View.  The  reports  can 
be  automatically  reprinted  by  CA-View  with  the  PRTCLSL  initialization 
parameter.  Since  the  reports  are  actually  reprinted  by  CA-View,  they  are 
identified  to  JES  xmder  the  name  of  the  archival  started  task  and  not  imder  the 
name  of  the  creating  job.  When  reports  are  printed  they  contain  banner  pages 
produced  by  CA-View,  identifying  the  creating  job. 

Alternatively,  with  the  automatic  report  archival  feature,  reports  are  printed 
directly  by  JES  and  are  identified  to  it  imder  the  name  of  the  creating  job;  a 
duplicate  of  the  reports  is  produced  by  the  automatic  report  archival  feature  for 
"spin-off"  to  CA-View, 

The  last  line  of  any  page  of  a  report  should  not  have  a  channel  skip  statement.  If  a 
report  has  a  channel  skip  statement  at  the  bottom  of  a  page,  you  must  follow  it 
with  a  blank  line;  otherwise  the  channel  skipping  is  not  honored.  For  more 
information  about  the  automatic  report  archival  feature,  see  the  section 
Automatic  Report  Archival  later  in  this  chapter. 
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Archival  of  SYSLOG  Data 

You  can  select  SYSLOG  data  for  archival  by  SYSOUT  class.  When  SYSLOG  data 
is  queued  for  print  using  the  WRITELOG  operator  command  or  at  IPL  time,  it 
can  be  archived  by  GA-View.  Therefore,  if  you  want  to  archive  SYSLOG  data, 
you  need  to  have  your  SYSLOG  data  queued  for  print  at  regular  intervals.  The 
length  of  the  interval  determines  the  age  of  the  most  current  archival  group  of 
SYSLOG  data. 

You  can  use  the  automatic  command  facility  to  queue  SYSLOG  data  at  regular 
intervals.  For  example,  to  queue  SYSLOG  data  on  an  hourly  basis  for  archival  to 
CA-View,  establish  the  following  automatic  command  as  part  of  your  3PL 
procedure: 

$TA,  1=3600,  '$VS"W'  " 


You  should  coordinate  the  process  of  implementing  archival  of  SYSLOG  data 
with  your  systems  programming  staff. 


AFP  Report  Archival 

CA-View  allows  you  to  archive  AFP  reports  with  a  CA-View  AGIF  (AFP 
Conversion  and  indexing  Facility)  archiver. 

An  AGIF  archiver  is  defined  as  a  functional  subsystem  application  (FSA)  that 
runs  under  a  separate  address  space  called  a  Fimctional  Subsystem  (FSS).  A 
Functional  Subsystemlnterface  (FSI)  maintains  commimication  between  the  FSS 
and  the  JES  global  address  space.  AFP  Conversion  and  Indexing  Facility  (AGIF ) 
is  a  utility  that  is  part  of  the  IBM  PSF/MVS  product. 

For  CA-Deliver  clients,  AFP  data  cannot  be  archived  via  GA-Deliver  direct  to 
CA-View  archival;  it  must  be  archived  from  JES. 


Starting  and  Stopping  ACiF  Archival 

Under  JES2,  an  AGIF  archiver  FSA  can  be  started  in  one  of  the  following  ways: 

■  An  operator  can  enter  the  START  DEVICE  JES2  command 

■  When  JES2  is  brought  up,  AGIF  archival  starts  automatically  if  the  PRTnnnn 
statement  for  the  printer  FSA  contains  the  START  parameter 
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Under  JES3,  an  ACIF  archiver  FSA  can  be  started  in  one  of  the  following  ways: 

■  An  operator  can  enter  the  START  WRITER  JESS  coirunand 

■  ACIF  archival  is  started  by  JESS  when  printing  is  scheduled  fort  a  printer 
FSA 

If  you  do  not  want  archival  to  stop  after  each  job,  you  can  define  the  FSS  as  a  JESS 
"hot  writer,"  keeping  the  address  space  active. 

The  ACIF  archival  FSA  differs  from  normal  printers  in  that  it  can  only  be  started 
and  stopped.  Positioning  commands,  such  as  those  to  interrupt  a  printer,  forward 
space,  or  back  space  the  printer,  carmot  be  used. 


Installing  a  CA-View  ACIF  Archiver 

For  information  about  installing  a  CA-View  ACIF  archiver,  see  the  CA-View 
Installation  Guide. 


Viewing  AFP  Reports 

You  have  several  options  for  viewing  AFP  reports  through  CA-View  online.  You 
can: 

■  View  the  report  exactly  as  it  will  be  printed,  with  the  CA-View  Workstation 
product  (version  1.4.0  or  higher) 

■  View  the  text  portions  of  the  report  on  a  S270  terminal,  by  simply  selecting 
the  report 

■  View  (and/or  print)  a  GDQF  composed  version  of  the  report  on  a  S270 
GDDM  terminal  (IBM  product  GDQF  required) 


Indexing  AFP  Reports 

For  each  SYSOUT  data  set  to  be  processed  by  a  CA-View  ACIF  archiver,  a  set  of 
control  statements  can  be  used  to  define  indexing  criteria  and  provide  other 
attributes  for  archival. 

These  control  statements  are  created  as  members  of  the  SARINDEX  PDS, 
specified  in  the  CA-View  ACIF  start  procedure.  The  name  of  the  member  is 
coded  on  the  GR0UPID  parameter  of  the  / /OUTPUT  JCL  statement  for  the 
SYSOUT  data  set.  If  the  GROUPID  parameter  is  not  coded,  the  name  of  the 
member  defaults  to  the  job  name.  For  JESS  sites,  the  GROUPID  parameter  is 
supported  in  version  4.2  and  above  of  JESS. 
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See  CA-View  ACIF  Interface  in  ihe  CA-View  Installation  Guide  for  information 
about  installing  a  CA-View  ACIF  archiver. 

IBM  ACIF  Control  The  following  IBM  ACEF  control  statements  can  be  coded  for  a  CA-View 

Statements  ACIF  archiver: 

CPGID 

FIELDn 

6ROUPI12U1E 

IH&GEOTTT  (default  changed  to  ASIS) 

XNDEXn 

RESTYPE  (default  changed  to  ALIi) 

TRIGGERn 

IHDEXOBJ  (default  changed  to  ALL) 

For  more  information  about  ACIF  control  statements,  see  the  IBM  manual  AFP 
Conversion  and  Indexing  Facility:  Application  Programming  Guide,  G544-3824. 

CA-Vlew  ACIF  Control  In  addition  to  the  IBM  ACIF  control  statements,  you  can  code  the  following 
Statements  CA-View  ACIF  archival  control  statements: 

DOWNLOAB 

DOWNLOAD  specifies  up  to  256  user  IDs  to  which  the  archived  SYSOUT  will  be 
queued  for  downloading  to  CA-DocView  (formerly  CA-View  Workstation). 

REPORTID 

!  ; 

REPORTID  specifies  a  one-  to  twelve-character  name  imder  which  the  report  is  to 
be  archived.  If  omitted,  the  job  name  is  used,  except  for  CA-Deliver,  which  uses 
its  REPORTID. 

USERDATA 

USERDATA  specifies  one  to  twenty  bytes  of  user  data  to  be  stored  in  the 
GCRUSER  field. 


AFP  Report  Archival  Example 

The  following  is  an  example  of  implementing  the  CA-View  ACIF  archival 
interface  to  archive  an  AFP  report.  Detailed  installation  instructions  are  provided 
in  the  CA-View  Installation  Guide. 

Suppose  you  have  defined  a  CA-View  ACIF  archiver  to  JES2  as  device  PRT18. 
JES2  is  to  select  any  data  set  for  this  archiver  with  a  processing  mode  of  ACIF. 
The  name  of  the  start  procedure  is  SARFSS. 


I 
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JES2  Control 
Statements 


Start  Procedure  for 
SARFSS 


Device  Control 
Statements  for  PRT  DD 
Statement 


Sample  Application 
Job 


The  JES2  control  statements  to  be  coded  for  this  example  are: 


FSSDEF (FSSSAS)  FROC=SARFSS 
PRT18  FSS=FSSSAR, 

MODE=FSS, 

NOSEP, 

NOSEPDS, 

PKMODE= (AGIF) , 
WS=(PBH) 


The  start  procedure  for  SARFSS  is  as  follows: 


//SABFSS 

//SABFSS 

// 


PROC 

EXEC  P6H=SARFSS,TXME=1440v 
REGZON=2H 


//STEPIiZB  DD  DSH=CAZ.GAZLXB,DZSP=SHR 
//  DD  DSH=ACZF.LOAD,DZSP=SHR 

//SYSUDtJMP  DD  SYSOUT=A 

//SARZNDEX  DD  DSII=VZEH.  SARZNDEX,  DZSP=SHR 
/ /PRT18  DD  DSN=CAX . PPOPTZON { PRT18 ) , DZSP=SHR 

//SARLOG  DD  SYSOUT=A 


The  following  are  the  JES2  device  control  statements  for  PRT18  of  our  example: 


TYPEsACZP 
ARCHHSG=YES 
CHARS= ( GTZ5 , 6X15 ) 
FDEFDXB=SYS1 .  FDEFLZB 
FOfilTDZB=SYSl . FONTLIB , 
SYSl . FONTLIBB, 
GSF.USERFONT 
PDEFLZB=SYS1 . PDEFLZB 
OVI.YLZB=SYSl .  OVERDZB 
PSEGLZB=SYS1 .  PSEGIkZB 
FORHDEF=A10110 
FA6EDEF=V0  6683 
NEWFRHOD=PAGE 


The  following  is  a  sample  application  job  that  generates  SYSOUT  to  be  indexed 
by  CA-View  ACIF,  and  archived: 

//SAHPJOB  JOB  ACCOUNT, PROGRAMMER 

//Ol  OUTPUT  GROUPZD=S10056,PRMODE=AGZF, 

//  PAGEDEF=A18D>FORKDEF=A18Dl, 

//  USERIkXB=SAHPLE.USERDZB 

//STEPl  EXEC  PGM=MYAPPL 
//REPORT  DD  SYS0UT=A,00TPUT=*.01, 

//  DCB=(RECFM=FA,BLKSZZE=133) 
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Following  is  the  report  generated  by  the  application  MYAPPE: 
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XYZCORP  34792788  6  73 

MDCE  JOHN  DOE 


New,  Page 
Group 


ED369 
3333  5SS55 
3333  555 55 
33  33  5  55  SS 
3333  55555 
3333  55555 
3333  5SS 
3333  5  55 SS 
3333  5  S5S 
3333  555 55 
3333  55S5S 
3333  55555 


92384  49588  2346 
92384  495882346 
92384  49588  2346 
92384  49588  2346 
92384  495882346 
92384  49588  2346 
92384  49588  2346 
92384  4958  8  2346 
92384  4958  8  2346 
92384  495882346 
92384  4958  8  2346 


26766644 
43766544 
88766644 
59766644 
34766644 
98866544 
6676 6644 
23766544 
36766644 
74766644 
65466544 


007777  44333  C8 662 
0077 77  44333  C8 662 
007777  4433  3  03662 
007777  44333  03662 
007777  44333  03662 
C07777  44333  OS 662 
00  7777  4433  3  06662 
007777  4433306662 
007777  4433  3  03662 
007777  44333  OS 662 
007777  44333  CS 662 


ACIF  Control 
Statements 


The  following  ACIF  control  statements  are  in  member  S10056  of  the 
SARINDEX  PDS.  For  information  about  coding  the  ACIF  control  statements, 
see  the  IBM  manual  AFP  Conversion  and  Indexing  Facility:  Application 
Programming  Guide,  G544-3824: 


TRIGGBR1=*,1, '1' 

TRX66ER2!=0, 120, 'PAGE  1' 

FXEIiDl=2,9,24 
FXELD2s:2,40,8 
FXELD3=0,16,10 
FXELD4='A10“' 

XNDEX1= ' Customer  name ' , FXBLDl 

XNDEX2  = 'Account  Number FXEI.D4 ,  FXELD2 

XNDEX3  = ' Division ' , FXELD3 

REPORTXDsFHONEBXLLS 

DOWNLOAD=JOHHB, 

HARYK, 

JXMT 


/*SELECX  page  group  by  skipping  to  chaimel  1 
/*  and  text  string  1 

/*  Data  field  containing  customer  name 
/*  Data  field  containing  account  number 
/*  Data  field  containing  division  name 
/*  constant 


Important!  You  should  indexreports  appropriately  to  minimize  the  size  of  page  groups 
because  you  can  view  AFP  reports  using  CA-View  Workstation  Release  1.6  or 
GA-DocView  2.0  on  a  PC.  In  this  example,  we  used  the  characters  "PAGE  1 "  as  the 
TRIGGER  to  signify  a  new  page  group,  then  indexed  on  the  CUSTOMER  NAME  and 
ACCOUNT  NUMBER. 
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Archiving  Xerox  Reports  (XPDS) 

CA-View  allows  you  to  archive  Xerox  reports  with  a  CA-View  DVS  archiver. 

DVS  is  the  Document  Viewing  Service,  software  developed  by  Document 
Sciences  Corp. 

A  DVS  archiver  is  defined  as  a  functional  subsystem  application  (FSA)  that  runs 
tmder  a  separate  address  space  called  a  Functional  Subsystem  (FSS).  A  Functional 
Subsystem  Interface  (FSI)  maintains  commuiucation  between  the  FSS  and  the  JES 
global  address  space. 

For  CA-Deliver  customers,  XPDS  data  cannot  be  archived  via  CA-Deliver  direct- 
to^CA-View  archival;  it  must  be  archived  from  JES. 

You  can  only  view  XPDS  reports  via  CA-DocView  (formerly  CA-View 
Workstation). 


Starting  and  Stopping  DVS  Archiver 

Under  JES2,  a  DVS  archiver  FSA  can  be  started  in  one  of  the  following  ways: 

■  An  operator  can  enter  the  START  DEVICE  JES2  command 

■  When  JES2  is  brought  up,  DVS  archival  starts  automatically  if  the  PRTwnnn 
statement  for  the  printer  FSA  contains  the  START  parameter.  Under  JESS,  a 
DVS  archiver  FSA  can  be  started  in  one  of  the  following  ways: 

■  An  operator  can  enter  the  START  WRITER  JESS  command. 

■  DVS  archival  is  started  by  JESS  when  printing  is  scheduled  for  a  printer  FSA. 

If  you  don't  want  archival  to  stop  after  each  job,  you  can  define  the  FSS  as  a  JESS 
hot  writer,  keeping  the  address  space  active. 

The  DVS  archival  FSA  differs  from  other  printers  because  it  can  only  be  started 
and  stopped.  Positioning  commands  such  as  commands  that  interrupt  a  printer, 
like  forward  space  or  back  space  the  printer,  cannot  be  used. 


installing  a  CA-View  DVS  Archiver 


See  information  about  installing  a  CA-View  DVS  archiver  in  the  CA-Wera 
Installation  Guide. 
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indexing  Xerox  (XPDS)  Reports 


For  processing  of  each  SYSOUT  data  set  by  a  CA-View  DVS  archiver,  you  can  use 
a  set  of  control  statements  to  define  indexing  criteria  and  provide  other  attributes 
for  archival. 

These  control  statements  are  created  as  members  of  the  SARINDEX  PDS, 
specified  in  the  CA-View  DVS  start  procedure.  The  name  of  the  member  is  coded 
on  the  GROUPID  parameter  of  the  /  / OUTPUT  JCL  statement  for  the  SYSOUT 
data  set.  If  the  GROUPID  parameter  is  not  coded,  the  name  of  the  member 
defaults  to  the  job  name.  For  JESS  sites,  the  GROUPID  parameter  is  supported  in 
JESS  version  4.2  and  higher. 

See  CA-View  DVS  Interface  in  CA-View  Installation  Guide  for  information 
about  installing  a  CA-View  DVS  archiver. 

For  information  about  DVS,  see  the  Document  Sciences  manual  Document 
Viewing  Service,  DVS  Programmer's  Guide,  DVS-PRTEMU. 

CA-View  DVS  Control  You  can  code  the  following  CA-View  override  DVS  archival  control  statements  to 
Statements  enhance  or  override  the  control  statements  m  the  PRTnn  data  sets. 


Control  Stotementi 

Description 

DOWNLOAD= 

Specifies  up  to  256  user  IDs  to  which  the  archived 
SYSOUT  will  be  queued  for  downloading  to  the 
CA-View  Workstation  (CA-DocView) 

DOBFORMS=YESINO 

Specifies  whether  to  process  Bforms  by  the  printer 
emulator  and  add  to  the  output  CCIF 

If  NO  is  specified,  any  pages  containing  Bforms  will 
not  appear  in  the  output  CCEF. 

DOBLNKPG=YESINO 

Specifies  whether  the  emulator  should  create  blank 
pages  in  the  output  CCIF  for  blank  pages  in  the  input 
XPDS 

INDXLANG= 

ASCni  EBCDIC 

Specifies  whether  to  generate  the  text  in  index  lists  in 
ASCn  or  EBCDIC 

JDINAME= 

Specifies  the  name  of  the  JDI  member  of  the  printer 
resource  CCIF  to  use  for  controlling  index  list 
generation 

Omit  this  statement  if  you  don't  want  to  perform 
indexing.  Do  not  specify  the  .JDL  suffix.  The 
maximtun  name  length  is  six  characters. 

Continued 
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Continued 


Control  Statement 

Description 

LiOGFILE= 

Specifies  the  DDname  of  a  file  to  which  the  emulator 
writes  logging  information,  X^Y  text  dumps,  and 
missing  resource  error  messages 

onilansi=yesino 

Forces  the  printer  emulator  to  accept  ANSI-style 
print  carriage  control  for  online  jobs  instead  of  IBM 
3211  print  carriage  control 

PPRHITE= 

Specifies  the  paper  height  in  either  dots  or  xdots 

PPRUNITS= 

Specifies  the  units  in  which  PPRHITE  and 

DOTS  1 XDOTS 

PPRWIDTH  are  specified 

There  are  300  dots  per  inch  and  600  xdots  per  inch. 

PPRWIDTH= 

Specifies  the  paper  width  in  either  dots  or  xdots 

RDBCCIF=: 

Specifies  the  data  set  name  of  the  default  CCIF  that 
contains  the  printer  resource  data 

REPORTED^ 

Specifies  a  one-  to  twelve-character  REPORTID  for 
the  archive  report 

If  omitted,  the  job  name  is  used,  except  for 

CA-Deliver,  which  uses  its  REPGRTIDi 

STARTJDL= 

Specifies  the  startup  JDL 

Do  not  specify  the  JDL  extension.  The  maximum 
STARTJDL  length  is  six  characters. 

STARTJDE= 

Specifies  the  startup  JDE 

Maximum  ST ARTJDE  length  is  six  characters. 

UNIQIMSGS=YES  i  NO 

Specifies  whether  different  download  IMGs  (images) 
in  the  XPDS  have  different  names 

If  YES  is  specified,  downloaded  IMGs  ini  the  XPDS 
have  unique  names.  If  two  separate  IMGs  have  the 
same  name,  they  are  assumed  to  be  the  same  IMG.  If 
NO  is  specified,  the  XPDS  can  have  two  or  more 

IMGs  with  the  same  name,  although  the  contents  can 
be  different. 

USERDATA= 

Specifies  one  to  twenty  bytes  of  user  data  to  be  stored 
in  the  GCRUSER  field 

XYDUMP=YESINO 

Indicates  whether  to  create  and  write  a  diagnostic  Xr 
Y-text  dump  of  the  XPDS  to  the  logfile  data  set 
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Xerox  (XPDS)  Report  Archival  Example 


The  following  example  describes  implementation  of  the  CA-View  DVS  archival 
interface  to  archive  an  XPDS  report.  Detailed  installation  instructions  are  in  the 
CA-View  Installation  Guide. 


Note:  You  must  pre-load  the  indexing  statements  in  this  example  as  member 
PHONE.JSI  of  PHONE.RESOURCE.CCIF  and  compiled  as  member  PHONE.JDL. 
See  the  Document  Sciences  manual  Document  Viewing  Service,  DVS  Programmer's 
Guide,  DVS-PRTEMU,  for  information  about  coding  the  .JSI  member. 


Example  Let's  assume  you  have  defined  a  CA-View  DVS  archiver  to  JES2  as  device 

PRTI8.Y0U  want  JES2  to  select  any  data  set  for  this  archiver  with  a  processing 
mode  of  DVS.  The  name  of  the  start  procedure  is  SARFSS. 


Code  the  following  JES2  control  statements  as  follows: 

FSSDEF(FSSSAR)  PROC=SASFSS 
PRT18  FSS=FSSSAR, 

HODE=FSS, 

NOSEP, 

HOSEPDS, 

PRMODE= (DVS) , 

WS=(PRH) 


The  start  procedure  for  SARFSS  is  as  follows: 


■  //SARFSS 

//SARFSS 

// 

//STEPLIB 

// 

//SYSUDUKP 

//SARINDEX 

//PRT18 

//SARLOG 

/ /SYSPRINT 

//TMP18 

// 

//1DX18 

// 

//RES18 

// 

//DOC13 

// 


PROC 

EXEC  P6H=SARFSS,TXME=1440, 

RE6IOH=2H 

DD  DSN=CAX.CAXLXB,DZSP=SHR 
DD  DSN=DVS.I<OAD>DXSP=SHR 
DD  SYSOU®=A 

DD  DSN=VIEW.SARXNDEX,DXSP=SHR 
DD  DSN=CAI . PPOPTXON { PRT18 ) , DXSP=SHR 
DD  SYSOUT=A 
DD  SYSOUT=A 

DD  UNXT=SYSDA, SPACE= (CYL, 10 ), 

DCB= (RECFM=FBS, LRECL=8192 , BDKSIZE=8192 ) 
DD  UNIT=SYSDA, SPACES (CYL, 10 ) , 

DCB=  (RECFUsFBS,  LRECL=8192  ,  Bi:.KSZZE=8192  ) 
DD  UNIT=SYSDA, SPACES (CYL, 10) , 

DCBs (RECFHsFBS, LRECLs8192 , BLKSXZE=8192 ) 
DD  UNXTsSYSDA, SPACES (CYL, 10) , 

DCBs (RECFHsFBS, LRECLs8192 , BLKSXZEs8192 ) 


All  temporary  CCIFs  should  be  blocked  with  the  indicated  JGL.  Use  UNIT=V1G  if 
possible. 
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The  following  are  the  JES2  device  control  statements  for  PRT  DD  Statement 
PRT18  of  this  example: 

TYPE=DVS 

ARCHHS6=YES 

DOBLNKPGsYES 

PFRHXTE=3300 

PPRUIIXTS=DOa*S 

PPRWIDTH=2550 

IU}BCCIF=SYS1 . DVS . RESOORGE 

T«PDDN=THP18 

IDZDDN=XDX18 

RESDDH=RES18 

DOCDDN=DOC18 

N&HEsVXEW. SYSEHl 

STARTaDE=STD 

START  JDI.=STD 

NEWPRHODsPAGE 


Sample  Application  Job 

The  following  is  a  sample  application  job  that  generates  SYSOUT  to  be  indexed 
by  CA-View  DVS,  and  archived: 

//SAHPJOB  JOB  ACCOUNT, PROGRAMMER 
/ / 0 1  OUTPUT  GROUPXD=S10 056, PRMODE=DVS  , 

//STEPl  EXEC  PGM=HYAPPL 
/ /REPORT  DD  SYSOUT=A, OUTPUT=  *.01, 

//  DCB=(REGFM=PA,BIiKSXZEal33) 

'■sj 

DVS  Control  Statements 

The  following  DVS  control  statements  are  in  member  S10056  of  the  SARINDEX 
PDS: 

STARTJDB=PHOME 
STARTJDE=:OMIilNE 
RDBCGXF=PHONE . RESOURCE . CCXF 
JDINAME=PHONE 
REPORTXD=PHONEBXLLS 
DOWNLOAD^ JOHNB , 

HARYK, 

JIMT 

Important!  You  should  index  the  reports  appropriately,  to  minimize  the  size  of  the  page 
groups,  since  the  XPDS  report  is  downloaded  from  mainframe  storage  to  the  PC  to  be 
■  ■■  viewed  with  CA-DocView  (formerly  CA-View  Workstation).  Avoid  downloading  any 
unnecessary  pages. 


w 
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Exceptional  Condition  Checking  (System  and  User-Specified 
Conditions) 


When  archiving  SYSOUT,  CA-View  scans  each  record  for  exceptional  conditions. 
You  can  have  CA'View  check  for  an  lEF  system  code,  such  as  IEF142I!  or  you  can 
specify  any  string  of  text  to  search  as  a  user-specz^ied  condition. 

You  specify  the  exception  conditions  with  control  statements  to  the  archival 
started  task  SARSTC.  Each  control  statement  applies  to  one  or  more  jobs  by 
specific  or  wildcard  job  names. 

For  completion  codes  and  abends,  the  control  statement  canhe  further  qualified 
to  a  specific  step  and/ or  procedure  step.  A  default  control  statement  is  provided 
to  override  one  or  all  of  the  system  defaults. 

To  enable  editing  of  the  exceptional  condition  table  while  the  started  task  is 
active,  the  table  must  be  established  as  a  member  of  a  PDS  rather  than  a 
sequential  data  set. 


System  Exceptional  Conditions 

CA-View  checks  the  following  elements  to  set  exceptional  conditions: 

■  Identifier  of  the  associated  error  message 

■  Control  statement  parameters  associated  with  that  message  ID 

■  System  default  parameter 

System  Conditions  The  corresponding  exception  code  is  stored  in  the  group  control  record 

(GCR)  for  the  SYSOUT  group.  The  table  below  lists  the  system 
conditions  CA-View  will  check: 


Condition 

Message  ID 

Parameters 

System 

Default 

Exception  Code 

Condition  code 

IEF142I 

CC 

CC>nnnn 

CCnnnn 

NOCC 

NOCCnnnn 

CC 

nnnn 

(Condition  code) 

Data  set  not  deleted 

IEF283I 

NDEL 

NONDEL 

NDEL 

NOTDEL 

Data  set  not  cataloged 

IEF287I 

NCAT 

NONCAT 

NCAT 

NOTCAT 

Continued 
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Condition  1 

Message  ID 

Parameters 

System 

Defauiti 

Exception  Code 

Data  set  not  re-cataloged 

IEF287Ii 

RCAT 

NORCAT 

RCAT 

NTRCAT 

Data  set  not  un-cataloged 

IEF287I' 

UCAT 

NOUCAT 

UCAT 

NTUCAT 

JGL  error 

IEF452I 

IEF453I 

JCL 

NOJCL 

JCL 

JCLERR 

Operator  cancel 

IEF251I 

OCNCL 

NOOCNCL 

OCNCL 

OCNCL 

System  abend 

IEF472I 

SYSSYSxia: 

NOSYS 

NOSYSxx:c 

SYS 

Sxxx 

(abend  code) 

User  abend 

IEF472I 

USER 

VSERnnnn 

NOUSER 

NOUSERnnnn 

USER 

Unnnn 
(abend  code) 

FIRST  and  LAST  The  parameters  FIRST  and  LAST  are  provided  to  specify  whether  the  exception 

Specifications  code  for  the  first  or  last  exception  condition  for  the  SYSOUT  group  should  be 

retained  in  the  group  control  record.  LAST  is  the  system  default. 


Control  Statements  Control  statements  are  input  to  the  archival  started  task  using  the  SARXCTAB 
for  System  Conditions  DD  statement  and  the  following  general  structure: 

/ID  parameters 


The  slash  is  coded  in  column  1  and  is  immediately  followed  by  the  job  name.  One 
or  more  blanks  must  foUow  the  ID  and  separate  it  from  the  parameters. 
Individual  parameters  are  separated  by  one  or  more  blanks  and/or  commas.  A 
statement  that  exceeds  71  characters  must  be  continued  on  additional  cards. 

When  continuing  a  statement,  interrupt  the  statement  only  between  complete 
parameters. 
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Parameters  in  the 
Control  Statements 


The  IE)  identifies  the  job  to  which  the  statement  applies.  The  statement  is  as 
follows: 

jobname  (t .  stepaame  t.procatepname)) 
where: 


jobname  Specifies  the  name  of  the  job  to  which  the  statement  applies 

You  can  specify  a  generic  job  name  by  appending  an  asterisk  to 
the  generic  name.  For  example,  a  job  name  of  PROD*  specifies 
that  the  statement  applies  to  any  job  having  the  first  four 
characters  of  its  name  being  PROD. 

stepname  Specifies  the  name  of  the  job  step  to  which  the  statement  applies 

stepname  is  optional  and  can  oi\ly  be  coded  for  completion  code 
and/ or  abend  exceptions.  If  omitted,  the  statement  wUl  apply  to 
aH  job  steps. 

procstepname  Specifies  the  name  of  the  procedure  step  to  which  the  statement 
applies 

procstepname  is  optional  and  can  only  be  coded  for  completion 
code  and/or  abend  exceptions.  If  omitted,  the  statement  applies 
to  all  procedure  steps. 

Because  qualification  by  job  and  procedure  step  names  only  applies  to 
completion  code  and  abend  exceptions,  multiple  control  statements  may  be 
required  for  the  same  job.  One  statement  specifies  only  the  job  name  without 
further  qualification. 

All  parameters  applicablte  to  the  entire  job  are  coded.  Additional  statements, 
qualified  to  a  particular  job  and  procedure  steps,  are  also  used.  Only  the 
completion  code,  system  parameters,  and  user  abend  parameters  are  coded  on 
these  additional  statements.  You  can  code  the  following  parameters: 


Parameter  Description 

GG  Specifies  the  following: 

■  A  condition  code  message  for  a  non-zero  condition  code  is 
treated  as  an  exceptional  condition 

■  A  condition  code  message  for  a  zero  (0)  condition  code  is  not 
treated  as  an  exceptional  condition 

NOGG  Specifies  that  there  are  no  condition  code  exception  conditions 

Continued 
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Parameter 

Description 

CC>nnnn 

Specifies  that  a  condition!  code  message  with  a  condition  code 
greater  than  nnnn  is  treated  as  an  exceptional  condition  xmless: 

■  A  NOCCnnnn  parameter  is  also  specified  for  the  condition  code 
and  that  a  condition  code  message  with  a  condition  code  less 
than  or  equal  to  nnnn  is  not  treated  as  an  exceptional  condition 

■  A  GGnnnn  parameter  is  also  specified  for  the  condition  code 

GGnnnn 

Specifies  the  following: 

■  A  condition  code  message  with  a  condition  code  equal  to  nnnn 
is  treated  as  an  exceptional  condition 

■  A  condition  code  message  with  a  condition  code  not  equal  to 
nnnn  is  not  treated  as  an  exceptional  condition  unless 
specifically  identified  as  an  exceptional  condition  by  another 
GGnnnn  or  GG>nnnn  parameter 

NOCCnnnn 

Specifies  the  following: 

■  A  condition  code  message  with  a  condition  code  equal  to  nnnn  is 
not  treated  as  an  exceptional  condition 

■  A  condition  code  message  with  a  condition  code  not  equal  to 
nnnn  is  treated  as  an  exceptional  condition  unless  specifically 
identified  as  not  being  an  exceptional  condition  by  another 
NOGGnnnn  or  CC>nnnn  parameter 

0000  specifies  that  when  multiple  exceptions  occur  for  a  SYSOUT 
group,  the  first  exception  code  for  the  group  is  retained  in  the  group 
control  record. 

000  specifies  that  a  JGL  error  message  is  treated  as  an  exceptional 
condition. 

NOJCL 

Specifies  that  there  are  no  JGL  exception  conditions 

LAST 

Specifies  that  when  multiple  exceptions  occur  for  a  SYSOUT  group, 
the  last  exception  code  for  the  group  is  retained  in  the  group  control 
record 

NGAT 

Specifies  that  a  NOT  GATALOGED  message  is  treated  as  an 
exceptional  condition 

NONGAT 

Specifies  that  a  NOT  GATALOGED  message  is  not  treated  as  an 
exceptional  condition 

NDEL 

Specifies  that  a  NOT  DELETED  message  is  treated  as  an  exceptional 
condition 

Continued 
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Parameter 

Description 

NONDEL 

Specifies  that  a  NOT  DELETED 'message  is  not  treated  as  an 
exceptional  condition 

OCNGL 

Specifies  that  an  OPERATOR  GENGEL  IN  ALLOGATION 
REGOVERY  message  is  treated  as  an  exceptional  condition 

NOOCNCL 

Specifies  that  an  operator  cancel  in  allocation  recovery  message  is 
not  treated  as  an  exceptional  condition 

RCAT 

Specifies  that  a  NOT  REGATALOGED  message  is  treated  as  an 
exceptional  condition 

NORCAT 

Specifies  that  a  NOT  REGATALOGED  message  is  not  treated  as  an 
exceptional  condition 

SYS 

Specifies  that  a  system  abend  code  message  for  any  abend  code  is 
treated  as  an  exceptional  condition 

NOSYS 

Specifies  that  a  system  abend  code  message  for  any  abend  code  is 
not  treated  as  an  exceptional  condition 

SYSxxx 

Specifies  that  a  system  abend  code  message  for  abend  code  xxx  is 
treated  as  an  exceptional  condition  and  that  a  message  for  any  abend 
code  other  than  xxx  is  not  treated  as  an  exceptional  condition  unless 
specifically  identified  as  an  exceptional  condition  by  another  SYSrrx 
parameter 

NOSYSxarrc 

Specifies  that  a  system' abend  code  message  for  abend  code  xxx  is 
not  treated  as  an  exceptional  condition  and  that  a  message  for  any 
abend  code  other  than  xxx  is  treated  as  an  exceptional  condition 
unless  specifically  identified  as  not  being  an  exceptional  condition 
by  another  NOSYSrrr  parameter 

UCAT 

Specifies  that  a  NOT  UNGATALOGED  message  is  treated  as  an 
exceptional  condition 

NOUGAT 

Specifies  that  a  NOT  UNGATALOGED  message  is  not  treated  as  an 
exceptional  condition 

USER 

Specifies  that  a  user  abend  code  message  for  any  abend  code  is 
treated  as  an  exceptional  condition 

NOUSER 

Specifies  that  a  user  abend  code  message  for  any  abend  code  is  not 
treated  as  an  exceptional  condition 

USER«nnn 

Specifies  that  a  user  abend  code  message  for  abend  code  nnnn  is 
treated  as  an  exceptional  condition  and  that  a  message  for  any  abend 
code  other  than  nnnn  is  not  treated  as  an  exceptional  condition 
unless  specifically  identified  as  an  exceptional  condition  by  another 
USERjmnn  parameter 

Continued 
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Parameter 

Description 

NOUSER 

nnnn 

Specifies  that  a  riser  abend  code  message  for  abend  code  nnnn  is  not 
treated  as  an  exceptional  condition  and  that  a  message  for  any  abend 
code  other  than  nnnn  is  treated  as  an  exceptional  condition  ujkess 
specifically  identified  as  not  being  an  exceptional  condition  by 
another  NOUSERnnnn  parameter 

Default  Control  You  can  override  one  or  more  of  the  system  default  specifications  for  exception 

Statement  code  checking  on  the  default  control  statement.  The  default  control  statement 

must  be  the  first  statement  specified  and  its  ID  must  be  DEFAULT. 


The  following  is  an  example  where  exceptional  condition  checking  is  required: 

■  Only  condition  codes  greater  than  7  are  treated  as  exceptional  conditions 

■  User  abend  code  2000  and  not  re-cataloged  messages  are  ignored  (not  treated 
as  exceptional  conditions) 

■  Jobs  P27XY1,  P28A05,  and  P30R16  normally  end  with  user  abend  code  1000, 
so  user  abend  code  1000  is  not  treated  as  an  exceptional  condition  for  these 
jobs 

■  STEP2  of  all  jobs  whose  names  start  with  SYS  normally  terminate  with  user 
abend  code  16 

This  abend  is  not  treated  as  an  exceptional  condition. 

■  All!  other  conditions  are  exceptions  (the  system  defaults) 


You  code  control  statements  as  follows: 

/DEFAULT  GC>7  NOUSER2000  NORCaT 
/P27XY1  NOUSERIOOO  HOUSER2000 

/P28A05  NOUSERIOOO  NOUSER2000 

/P30R16  NOUSERIOOO  NOUSER2000' 

/SYS  * . STEP2  NOUSER16 


User-Specified  Conditions 

Control  statements  are  input  to  the  archival  started  task  using  the  SARXGTAB 
DD  statement.  For  each  statement,  the  percent  sign  is  coded  in  colimrn  1  and  is 
immediately  followed  by  the  ID.  One  or  more  blanks  must  follow  the  ID  and 
separate  it  from  the  parameters.  Individual  parameters  are  separated  by  one  or 
more  blanks  and/ or  commas.  A  statement  that  exceeds  71  characters  must  be 
continued  on  additional  cards.  When  continuing  a  statement,  interrupt  the 
statement  only  between  complete  parameters. 
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Syntax 


The  control  statements  have  the  following  general  structure: 

%ID  '  string^  COXiibbbbbioeeee)  ltllSlE{bbbbbb:eeeBee) 
XeODEtJOCXXJCx)  STOP  EXCijobl,  job2 ,  .  .  .  ) 


Specifies  that  this  is  a  user-specified  condition 

For  each  statement,  the  %  sign  is  coded  in  column  1  and  is 
immediately  followed  by  the  ID. 

Specifies  the  job  name  of  the  SYSOUT  job  containing  the  user- 
defined  string 

You  can  specify  a  generic  job  name  by  appending  an  asterisk  to 
the  generic  name.  For  example,  a  job  name  of  PROD*  specifies 
that  the  statement  applies  to  any  job  having  the  first  four 
characters  of  its  name  being  PROD.  A  statement  beginning  with 
%*  would  include  all  jobs. 

Specifies  the  string  of  alphanumeric  data  to  be  found  in  the 
SYSOUT  that  signifies  the  exceptional  condition 

Enclose  the  string  in  single  quotes. 

COL(UMN)  G01.(UMN)  specifies  the  coliunn  number  (bbbbb)  or  range 
{bbbbbxeeee)  where  the  string  begins  in  the  SYSOUT  record 

The  default  is  COL(l)  where  the  string  begins  in  column  1. 
COLUMN  includes  the  assumed  carriage  control  in  the  column 
position.  This  is  not  sensitive  to  the  CCONDISP  initialization 
parameter  which  controls  the  viewing  of  carriage  control 
characters  in  online  logical  viewing.  COLUMN  can  be 
abbreviated  as  COL. 

LINE  LINE  specifies  the  beginning  line  number  {bbbbbb)  or  range  of 

lines  (bbbbbb'.eeeeee)  to  include  in  the  search  for  the  string 

The  default  is  LINE(1:999999)  which  specifies  that  the  entire 
SYSOUT  group  is  searched.  LINE  does  not  include  the  assumed 
carriage  control — it  operates  on  the  printed  line,  not  the  actual 
line. 

XCODE  Specifies  the  1-  to  6-character  exception  code  to  be  stored  in  the 

GCRXCODE  field  when  the  string  is  matched 

The  EXCLUDE  statement  overrides  XCODE.  The  default  is 
CODE()  to  blank  out  the  XCODE. 


where: 

% 

ID 

'string' 
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SARSTCUX  and 

Exception 

Specification 

Refreshing  the 
Exception  Parameters 


STOP  STOP  specifies  to  tihe  archiving  task  to  freeze  the  XCODE  for  the 

SYSOUT  group  after  a  string  match 

Exceptional  conditions  are  b3rpassed  for  the  remainder  of  the 
group  except  for  updates  to  GCRXCODE  by  a  customized 
SARSTCUX  or  SARXGTUX  exit.  This  parameter  is  optional. 

EXCLUDEO  EXCLUDE()  specifies  to  exclude  specific  jobs  when  a  generic 
name  (with  wildcard,  *)  is  present  in  the  ID  field 

This  parameter  can  be  repeated  on  additional  cards  if  required. 
EXCLUDE  overrides  the  XCODE  statement  if  it  is  specified. 
EXCLUDEO  can  be  abbreviated  EXC(),  The  parenthesis  are 
required. 

The  following  is  an  example  where  exceptional  condition  checking  is  required: 

■  System  abends  122  and  222  are  not  considered  exceptions 

■  For  job  JOBl,  condition  codes  lower  than  8  are  ignored 

■  For  job  names  starting  with  PAY,  except  for  PAYll  and  PAY22,  store 
CANCEL  as  the  XCODE  for  system  message  IEF251I  and  bypass  any  other 
exceptions 

The  control  statements  are  coded  as  follbws: 

/DEFAULT  NOSYS122  NOSYS222 
/JOBl  CC>7 

SSPAY*  '1BF2511'  COL(l)  XCODE (CANCEL)  STOP 
EXC (PAYll  PAY22) 

You  can  also  identify  additional  exception  conditions  by  customizing  the 
SARSTCUX  exit. 


The  exceptional  condition-checking  parameters  are  established  when  the  archival 
task  is  started;  however,  they  can  be  changed  and  the  SARXCTAB  DD  statement 
re-opened  to  refresh  the  exceptional  conditions  parameters  at  any  time,  without 
stopping  to  restart  the  archival  task.  See  Refreshing  Exceptional  Condition 
Checking  later  in  this  chapter  for  specific  information  about  this  process. 
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Operating  the  Archival  Task 

The  following  sections  describe  the  commands,  parameters,  and  procedures 
necessary  tb  operate  the  archival  task. 


Starting  the  Archival  Task 


You  start  SAKSTC  with  one  of  the  following  operator  commands: 

S  SAKSTC 

S  SAKSTC,  OPT=DIJHP 
S  SAKSTC, OPT=IIEW 
S  SAKSTC,  OPT=Ci:.EAN 
S  SAKSTC,  OPT=IDiniP 
S  SAKSTC, OPT=INEW 


where: 


OPT=NEW  Specifies  that  the  archival  task  initiates  its  backup  cycle 

immediately  following  initialization  and  prior  to  archiving  any 
SYSOUT 


The  new  tape  generation  resides  on  a  new  tape. 

OPT=CLEAN  Specifies  that  tire  archival  task  performs  a  cleanup  of  its 

database  to  recover  space  for  any  SYSOUT  groups  that  are 
created  or  loaded  to  disk  when  a  system  crash  or  abend  of  the 
archival  task  occurs 


The  archival  task  automatically  performs  a  cleanup  operation  as 
part  of  its  backup  cycle. 

OPT=IDUMP  Specifies  that  an  interim  backup  cycle  is  initiated  immediately 
following  initialization  and  prior  to  archiving  any  SYSOUT 

This  backup  resides  on  the  same  tape  as  the  previous  backup 
provided  there  is  room  on  the  tape  because  the  archival 
generation  number  is  not  incremented.  (There  is  also  an 
initialization  parameter,  MAXGENT,  which  specifies  the 
maximum  number  of  generations  to  be  written  to  one  tape.) 

OPT=INEW  Specifies  that  the  archival  task  initiates  an  interim  backup  cycle 
immediately  following  initialization  and  prior  to  archiving  any 
SYSOUT 


The  archival  generation  number  is  not  incremented;  however, 
this  backup  resides  on  a  new  tape. 
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Tip:  \\  t  rfLommend  that  \  ou  add  command  S  s  ARsR  1 1  i-OLmher 
C.l)\I\l\Dti  o  THtostaittht  an hu al  t  autom  itu all\ 


Stopping  the  Archival  Task 

SARSTC  is  terminated  with  tJie  following  operator  command: 

P  SARSTC 


Initiating  the  Backup  Cycle 

Backup  to  tape  and  the  creation  of  a  new  disk  generation  are  normally  performed 
automatically  ata  site*defined  time  and  at  site-defined  intervals  thereafter; 
however,  tape  backups  can  be  initiated  at  any  time  with  one  of  the  foUbwing 
operator  commands: 

F  SARSTC, DUMP 
F  SARSTC, NEW 
F  SARSTC, IDUHP 
F  SARSTC, XNEW 

where: 

DUMP  Specifies  that  the  new  tape  generation  resides  on  the  same  tape  as  the 
previous  generation,  provided  there  is  room  on  the  tape  and  the 
maximum  number  of  generations  per  tape  (MAXGENT  initialiKation 
parameter)  is  not  exceeded 

NEW  Specifies  that  the  new  tape  generation  resides  on  a  new  tape 

IDUMP  Specifies  that  an  interim  backup  cycle  is  initiated 

This  backup  resides  on  the  same  tape  as  the  previous  backup; 
provided  there  is  room  on  the  tape,  because  the  archival  generation 
number  is  not  incremented.  (There  is  also  an  initialization  parameter, 
MAXGENT,  which  specifies  the  maximum  number  of  generations  to 
be  written  to  one  tape.) 

INEW  Specifies  that  an  interim  backup  cycle  is  initiated 

The  archival  generation  number  is  notincremented;  however,  this 
backup  resides  on  a  new  tape. 
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Unloading  the  Archival  Tape 

When  archiving  directly  to  tape,  the  archival  tape  remains  allbcated  and  in  use 
through  the  next  backup  cycle.  The  foUbwing  operator  command  causes 
GA-View  to  imload  and  unallbcate  the  archival  tape  immediately: 

Syntax  P  SARSTC, UNLOAD 

The  tape  is  allocated  again  by  CA-View  the  next  time  it  requires  the  tape. 


Deleting  SARSTC99  Messages 

When  CA-View  encounters  an  exceptional  condition  and  a  routing  code  other 
than  zero  is  specified  (as  defined  by  site  mitialization  parameter  ROUT), 
SARSTC99  operator  messages  are  produced  for  each  exceptional  condition!  You 
can  delete  these  operator  messages  from  the  operator  console  by  entering  the 
following  operator  command: 

Syntax  ^  sarstc,dom 


Manually  Requesting  Cieanup 

If  the  CA-View  archival  task  terminates  abnormaUiy  due  to  a  system  crash  or  an 
abend,  the  last  SYSOUT  group  that  archived  can  be  left  in  an  incomplete 
condition  (OPEN  status).  The  same  condition  can  occur  for  a  SYSOUT  group 
being  reloaded  to  disk  from  tape  by  a  user  (LOAD  status).  You  can  request  a 
cleanup  of  these  incomplete  SYSOUT  groups  by  the  following  operator 
corrunand: 

Syntax  F  SARSTC,  CLEAN 

A  manual  request  for  cleanup  is  only  necessary  after  system  crashes,  because  the 
archival  started  task  normally  performs  a  cleanup  operation  as  part  of  its  backup 
cycle. 


To  recover  the  space  occupied  by  a  SYSOUT  group  left  in  OPEN  or  LOAD  status, 
you  must  issue  two  cleanup  commands  at  least  four  hours  apart.. 


Archival  5-29 


Operating  the  Optical  Migration  Subtask 


Refreshing  Exceptional  Condition  Checking 

You  can  change  the  exceptional  condition  checking  parameters  established  when 
the  archival  task  was  started,  and  you  can  refresh  the  conditional  parameters 
with  the  following  operator  command: 

Syntax  f  sarstg, reset 

This  command  causes  the  currently  defined  parameters  to  be  cleared  and  the 
SARXCTAB  DD  statement  to  be  re-read. 


The  exceptional  conditions  parameters  are  refreshed  from  the  indicated  control 
statements.  See  the  section  Exceptional  Condition  Checking  earlier  in  this  chapter 
for  more  information; 


Operating  the  Optical  Migration  Subtask 

To  allbw  flexibility  in  scheduling  optical  migration;  you  can  use  a  separate 
subtask  imder  the  CA-View  started  task  to  control  migration  of  reports  to  optical 
disk.  See  Operating  the  Optical  Migration  Subtask  in  Chapter  10,  "Using  the 
Optical  Disk  Interface,"  for  details. 


Running  Multiple  Archival  Tasks 

Multiple  archival  tasks  can  be  run  at  the  same  time;  however,  each  task  must  use 
a  different  database.  The  archival  task  ENQs  on  the  high-level  qualifiers  of  the 
database  name  insure  that  a  different  database  is  used. 


Warning!  loi  sitestiirllrtm  moielhmunt  pioussoi  he  sim.  that  muiupiL 
archival  task,*,  with  the  ‘•ame  database  do  not  run  at  the  '-.line  tmie  on 
ditleient  proet-.'-ors  otherwi>,i  \ou  can  do  permanent  dam  tgj  to  the 
database  t_  K  \iev\  pjompts  the  operator  te’r^erltl^allon  vhtn  it  appears 
that  mother  t=tsk  with  the  same'  elatabiise  is  a]rt‘ad\  exci  titin:;  on  anntlu  r 


You  must  meet  the  foUbwing  requirements  when  running  multiple  archival  tasks: 

■  A  different  database  must  be  defined  and  used  for  each  task 

■  A  different  recovery  file,  if  used,  mustbe  defined  and  used  for  each  task 
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Automatic  Report  Archival 

The  automatic  report  archival  extension  allows  a  site  to  create  a  copy  of  its 
reports  for  archival  purposes.  The  original  reports  continue  to  print  as  usual. 

With  this  feature,  a  site  can  back  up  all  reports  or  a  specified  subset  of  reports.  If 
a  report  is  lost,  it  can  be  easily  reprinted  from  CA-View. 

The  word  report  in  the  previous  paragraph  applies  to  any  SYSOUT  data  set  for 
which  normal  open  and  close  processing  is  performed. 

The  automatic  report  archival  feature  is  activated  by  specifying  one  or  inore  sets 
of  specifications  m  the  CA-View  extension  parameter  field.  The  sets  of 
specifications  identify  the  reports  for  automatic  archival  by  job  class  and  SYSOUT 
class  and  specify  the  SYSOUT  class,  destination,  and  forms  name  used  to  create 
copies  of  the  reports  for  archiving. 


Non-Eligible  Output 

Normal  open  and  close  processing  is  not  performed  by  JES  for  the  job  log,  JGL 
listing,  and  job  message  data  sets.  Therefore,  the  job  log,  the  JCL  listing,  and  the 
job  message  data  sets  are  not  eligible  for  automatic  archival. 


CHKPT  Restrictions 


The  CHKPT  macro  and  the  CHBCPT=EOV  JCL  statement  must  be  used  with 
diiect-to-CA-View  report  archival  in  conjrmction  with  CA-Deliver,  and  cannot  be 
used  with  SARXTD  alone.  Furthermore,  to  use  CHKPT,  reports  must  be  set  up  as 
bimdles  in  this  CA-Deliver-to-CA-View  environment. 

Example  1  This  example  assumes  that  CA-View  is  set  to  archive  all  SYSOUT  with  a 

destination  of  remote,  (the  master  index  file  is  initialized  with  parameter 
DEST=99).  You  want  to  produce  and  archive  to  tape  a  copy  of  all  production 
reports  and  those  test  reports  written  to  SYSOUT  classes  J  and  K.  Production  jobs 
are  defined  as  those  jobs  with  classes  P,  Q,  R,  and  S.  Test  jobs  are  defined  as  all 
jobs  with  classes  T,  U,  V,  and  W. 

The  following  parameter  field  starts  the  CA-View  system  extensions: 

PARM=' , PQRS/*//R99//T, TOVW/JK//R99//T' 

Example  2  This  example  assumes  that  CA-View  is  set  to  archive  allSYSOUT  for  class  S  (the 

master  index  file  is  initialized  with  parameter  CLSL=S).  You  want  to  produce  and 
archive  to  disk  a  copy  of  all  reports  written  to  SYSOUT  classes  A  and  B/and  to 
produce  and  archive  directly  to  tape  all  other  reports. 

The  following  parameter  field  starts  the  CA-View  system  extensions: 

PARM= ' , */AB/S///D*  */»/S///T' 
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Batch  Job  Execution  of  the  Archival  Task 


Although  the  archival  program  is  distributed  for  execution  as  a  started  task,  it  is 
possible  to  run  it  as  a  batch  job  after  first  modifying  it  with  the  IBM  AMASPZAP 
utility. 


Important!  You  can  ensure  the  integrity  of  the  archived  data  since  the  programs  are 
only  executed  by  an  operator;  however,  after  modification  to  run  as  a  batch  job,  the 
integrity  of  the  archived  data  can  no  longer  be  assured,  since  any  user  could  execute  the 
program.  If  batch  execution  is  essential  to  your  operation,  you  must  provide  for  data 
integrity  in  other  ways,  such  as  placing  the  load  modules  in  a  password’-protected  library. 


To  modify  the  archival  program  to  nm  as  a  batch  job,  execute  the  following  job: 

//ARGHZAP  JOB  ACCOUNT, PROGRAMHBR 
//STEPl  EXEC  PGH=AHASPZAP 
//SYSPRINT  DD  SYSOUT=* 

//SYSLZB  DD  DSN=CAX.CAII.ZB,D1SP=SHR 
//SYSZN  DD  * 

NAME  SARSTC  SARSTG 
VER  06  00 
REP  06  FF 
/* 


Note;  Change  the  data  set  name  on  the  SYSLIB  DD  statement  to  the  name  of  the 
library  containing  the  CA-View  load  modules. 
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The  following  is  an  example  of  a  SARBKLST  report: 


ID 

JOB  NAME 

JOBID 

GEN 

SEQ 

ARC  DATE 

ARC  TIME  LOG 

LINES 

PAGES 

DASD  ELKS  XCODE  FILE 

TIME 

D68D50AE 

SARFSSCC 

STC01203 

*DVS 

RSRC* 

02/17/96 

17:44:11 

227 

70 

1 

18:37:56 

F268B50C 

SARFSSCC 

STC03326 

*DVS 

RSRC* 

02/20/96 

15:57:30 

157 

47 

2 

18:37:56 

779AA128  SARFSSCC 
TOTAL  REPORTS  AND 

STC01181 

RESOURCE 

*DVS  RSRC*  02/17/96 
GROUPS  DELETED  = 

15:58:42 

3 

100 

23 

1 

18:37:56 

SARBKLST 

02/28/96  18:37:46  SEQ=00047 
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V0L=428119  DPLX=*N0NE*  BACKUP  LIST  SGP=DEFAULT  DSN=VIEW. SYSTEMl . SARTAPE. 0000047 


ID 

JOB  NAME 

JOBID 

GEN 

SEQ 

ARC  DATE 

ARC  TIME 

LOC 

LINES 

PAGES 

DASD  BLKS 

XCODE  FILE 

TIME 

REPORTl 

COOCH03B 

JOB01396 

25 

12 

02/28/96 

17:29:42 

DISK. 

12600 

200 

265 

1 

18:37:46 

REPORTl 

COOCH03B 

JOB01395 

25 

11 

02/28/96 

17:29:39 

DISK. 

12600 

200 

265 

2 

18:37:48 

REPORTl 

COOCH03B 

JOB01394 

25 

10 

02/28/96 

17:29:35 

DISK 

12600 

200 

265 

3 

18:37:49 

REPORTl 

COOCHOSfi 

JOB01392 

25 

9 

02/28/96 

17:29:32 

DISK 

12600 

200 

265 

4 

18:37:51 

REPORTl 

COOCH03B 

JOB01391 

25 

8 

02/28/96 

17:29:28 

DISK 

12600 

200 

265 

5 

18:37:52 

REPORTl  COOCH03B  JOB01187 
TOTAL  REPORTS  BACKED  UP  TO 

25 

TAPE 

3 

02/17/96 

6 

16:17:45 

DISK 

12600 

200 

265 

6 

18:37:54 

SARBKLST 
02/28/96  18:37:56 
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PAGE 


26 
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MASTER  INDEX  BACKED  UP  AT  FILE 


7  ON  VOL  428119 


SARBKLST 

02/28/96  18:37:59 
TAPE  DATASET  NAME 


CA-VIEW  (2.0)  -  SYSTEM  ARCHIVAL  TASK 
TAPES  UNCATALOGUED  DURING  STANDARD  BACKUP  OP  GEN  26 

VOLSER 


PAGE 


VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 

VIEW. 


SYSTEMl , 
SYSTEMl . 
SYSTEMl , 
SYSTEMl , 
SYSTEMl . 
SYSTEMl , 
SYSTEMl . 
SYSTEMl , 
SYSTEMl , 
SYSTEMl , 
SYSTEMl , 
SYSTEMl , 


SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 

SARTAPE 


.T0000021 

.T0000022 

.T0000023 

,T0000025 

.T0000026 

.T0000027 

.T0000031 

,T0000032 

.T0000033 

.T0000034 

.T0000039 

.T0000040 


434675 

410838 

434804 

413175 

433066 

425245 

483693 

484218 

482487 

482060 

460308 

478871 
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In  This  Chapter 

This  chapter  includes  information  about  Expanded  Retention  Option  (ERO)  table 
statements,  assigning  SYSOUT  IDs  based  on  embedded  text,  tape  consolidation 
of  reports  (SARPAG),  SARPAC  reports,  and  running  SARPAG. 


Overview 


The  GA-View  initialization  parameters  NGEND  and  NGENT  specify  how  many 
generations  of  each  SYSOUT  remain  on  disk  and  tape. 

The  ERO  allows  you  to  specify  particular  SYSOUTs  as  having  expanded 
retention.  These  SYSOUTs  can  be  given  separate  retention  criteria. 

When  a  SYSOUT  has  expanded  retention,  you  can  specify  how  long  to  keep  the 
SYSOUT  in  the  database  (the  retention  period)  by  the  number  of  generations  to 
be  kept,  the  number  of  .copies  to  be  kept,  or  the  number  of  days  the  SYSOUT  is  to 
remain' on  the  database.  By  appropriately  setting  your  NGEND  and  NGENT 
parameters,  then  assigning  selected  SYSOUT  to  have  expanded  retention,  you 
can  set  up  a  minimmn  archival  retention  period  for  all  SYSOUT,  and  then 
selectively  archive  desired  SYSOUT  for  longer  periods  of  time. 

The  ERO  gives  you  the  added  flexibility  of  assigning,  at  archival  time,  SYSOUT 
IDs  based  on  text  strings  formd  within  the  SYSOUT  (PTEXTn  parameters). 

The  SARPAG  utility  is  part  of  the  ERO.  SARPAG  consolidates  backup  tapes, 
copying  only  current  reports  to  new  tapes. 


The  ERO  Table 


SYSOUTs  are  given  expanded  retention  status  with  entries  in  what  is  referred  to 
as  the  expanded  retention  table,  or  ERO  table.  Expanded  retention  table  entries  are 
defined  to  GA-View  via  the  SARPATAB  DD  statement  in  the  GA-View  started 
task  JCL,  and  in  the  SAKDSK2B  batch  job  for  optical  migration. 


Expanded  Retention  Option  6-1 


ERO  Table  Statements 


You  can  use  wildcards  in  the  expanded  retention  table  statements,  to  identify  all 
SYSOUT  IDs  that  contain  a  particular  character  string.  You  can  specify  wildcards 
at  any  location  in  the  SYSOUT  ID.  ABC*  and  AB’'C*D  are  valid  SYSOUT  ID 
entries  in  the  table. 

The  terms  expanded  retention  and  permanent  status  are  synonymous. 


Expiration  of  Retention 

Note:  When  the  TOTAL  retention  criteria  has  expired,  the  SYSOUT  ID  is  no 
longer  in  expanded  retention  status;  even  if  the  disk  retention  criteria  haven't 
expired,  total  retention  must  be  greater  than,  or  equal  to,  the  disk  retention. 

If  no  ERO  TOTAL  retention  is  specified  (COPIES,  RETPD,  GENS)>  the  INIT  parm 
PCOPIES  is  used  as  the  default.  If  corifUcts  occur,  the  greater  retention  prevails. 

TOTAL  retention  and  tape  retention  are  nearly  the  same  because  the  backup 
cycle  copies  a  report  to  tape  according  to  the  interval  settings. 

You  can  use  the  SARBKTUX  (user  exit)  to  target  specific  reports  that  should  not^ 
be  backed  up  to  tape. 


ERO  Table  Statements 


Expanded  retention  table  entries  are  input  to  the  CA-View  started  task  using  the 
SARPATAB  DD  statement  Expanded  retention  table  statements  are  written  as 
follows: 

/ sysout-id  parameter  {value} 


Single  PoInt-of-Control 

We  recommend  that  you  set  the  initialization  parameter  PRETAIN=TABLE.  With 
PRETArN=TABLE,  all  reports  are  deleted  when  they  expire  from  ERO,  rather 
than  going  to  NGEND  or  NGENT  initialization  parameter  control.  This  way,  the 
ERO  table  is  the  single  point-of-control  for  retention  of  ERO  reports. 


Table  Updates  (PDS  Member) 

Maintaining  the  ERO  table  as  a  PDS  member  allows  concurrent  updates  to  take 
place  while  the  SARSTC  archival  task  is  active.  Because  the  ERO  table  ts 
reprocessed  during  every  standard  backup  cycle,  any  updates  would 
automatically  take  effect  for  ttie  next  standard  backup  cycle  following  the  update. 
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When  Do  the  ERO  Table  Statements  Take  Effect? 


The  expanded  retention  table  statements  in  the  SARPATAB  DD  statement  of  the 
GA-View  started  task  JGL  go  into  effect  after  a  standard  backup  of  the  CA-View 
database.  Interim  backups,  speciHed  via  the  NBACKUP  initialization  parameter, 
do  not  evaluate  SYSOUTs  for  expanded  retention. 


Warning!  Do  not  -.ptcdv  free=close  m  thi,  s  \Rr  \T  \B  DD  stittintiil 
bn.au'.c  dip  1  RO  table  v\oulJ  be  tn  t  u  during  the  nrstbaikup  and 
Nubsequenl  bai-kup^  would  not  an.L-'S  jt 


When  re-establishing  your  product  code,  always  verify  that  the  ERO  parameters 
appear  on  the  OFTIONS  IN  EFFECT  listing  of  the  SARINTT  programi 


Writing  ERO  Tabie  Statements 

ERO  table  statements  are  made  up  of  SYSOUT  IDs  (mcluding  wildcards), 
parameters,  and  the  values  you  set  for  those  parameters. 

Expanded  retention  table  entries  are  input  to  the  CA-View  started  task  using  the 
SARPATAB  DD  statement.  Expanded  retention  table  statements  are  written  as 
foUbws: 


/sysout-ld  {all|hask|2ast} 

RETPD=nnnnn  GEMS=nnnnn  COPIES=nnnnn 

DRETPD=nnnnn  DGENS=nnnnn  DCOP lES =nnnnn 

iRETPPgnnimn  liRETPD=jtnnns 

STORG'RP=0torag’o-0roup-name 

DSK2  DAYS =nnnnn 

DSK2NOTP 

VIEWTAPE= {YES | NO} 

XCOND={YBS|NO} 

EXCLUDE 

DELETE 

■  The  slash  is  coded  in  column  1  and  is  immediately  foUbwed  by  the  SYSOUT 
ID. 

■  One  or  more  blanks  must  foUbw  the  SYSOUT  ID  and  separate  it  from  the 
ERO  table  parameters. 

■  Parameters  are  separated  by  one  or  more  blanks  and/or  commas,  and  can  be 
specified  in  any  order. 

■  A  statement  that  exceeds  71  characters  must  be  continued  on  additional 
cards.  When  continuing  a  statement,  interrupt  the  statement  between 
complete  parameters  only,  and  omit  the  slash  on  tibie  continuation  card. 

■  An  asterisk  in  colunrn'  1  indicates  a  comment  line. 
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Sysout  ID  Guidelines 

The  SYSOllJT  ID  is  the  first  parameter  in  the  statement  The  wildcard  character  (*) 
can  be  specified  at  any  position  in  the  ID  to  indicate  that  any  single  character  can 
match  in  that  position  (for  example,  ab**d*,  is  a  valid  SYSOUT  ID  entry). 

You  should  list  SYSOUT  IDs  from  the  most  specific  to  the  most  general  because 
ERO  evaluation  is  triggered  from  the  first  matching  entry  found,  searching  from 
the  top  of  the  table. 

The  following  is  an  example  of  specific-to-general  listing  statements: 

/ABCD*  SPECIFICAT10N2 
/ABC*  SPECIPICAOJIONl 

Note:  We  recommend  that  you  end  the  table  with  a  I*  entry.  This  entry  governs 
any  reports  that  were  selected  for  ERO  processing,  and  did  not  match  any 
previous  entry  in  the  table.  You  should  to  use  this  "catch-all"  entry  to  specify 
retention  for  MARKed  copies.  A  typical  statement  is: 

/*  HARK  DRETPD=5  RETPD=30 

This  statement  indicates  that  if  a  report  is  MARKed  online  or  in  batch  with 
SARBCH  for  expanded  retention,  and  no  other  entry  in  the  table  matched  the 
report,  it  will  stay  on  disk  for  5  days,  and  on  tape  for  30.  If  you  don't  specify  this 
entry  and  a  SYSOUT  is  selected  for  retention  (online  K  command  or  SARBCH 
/PERM  statement),  the  PCOPIES  initialization  parameter  is  used  as  the  default 
value  for  tape  and  disk  retention,  assuming  POPT=M. 


Selection  Parameters 

If  the  ALL,  LAST,  or  MARK  parameter  is  not  specified,  the  initialization 
parameter  POPT  is  used  as  a  default.  We  recommend  that  you  specify  MARK, 
ALL,  or  LAST  in  each  statement,  to  imderstand  and  verify  the  effects  of  the 
statements  in  your  expanded  retention  table. 


Parameter  Description 

ALL  Specifies  that  all  reports  for  the  SYSOUT  ID  from  the  current 

generation  are  evaluated  for  ERO  processing 

If  you  also  set  the  initialization  parameter  EROPRO=ALL,  the  entire 
database  is  considered  for  the  next  backup  cycle,  not  just  the  current 
generation.  If  EXCLUDE  is  also  specified,  then  all  SYSOUT  groups 
are  excluded;  and  are  governed  by  NGEND  and  NGENT.  If  ALL  is 
specified,  MARK  and  LAST  must  not  be  specified. 

Continued 
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Parameter  Description 

LAST  Specifies  that  tihe  last  (most  recent)  report  for  the  SYSOUT  ID  from 
the  current  generation  is  evaluated  for  ERG  processing 

LAST  is  t5rpically  used  for  program  compilation  listings.  If  you  also 
set  the  initialization  parameter  ERGPRG= ALL,  the  last  SYSOUT 
from  every  generation  is  considered,  not  just  the  current  generation. 
If  LAST  is  specified,  MARK  and  ALL  must  not  be  specified. 

MARK  Specifies  that  all  reports  for  the  SYSOUT  ID  for  the  current 
generation  are  evaluated  for  ERO  processing,  only  if  marked 
manually 

Manual  marking  for  ERG  selection  is  done  with  the  online  K  (KEEP) 
command,  and  in  batch  with  the  PERM  statement  of  the  SARBCH 
utility.  If  MARK  is  specified,  LAST  and  ALL  must  not  be  specified. 


Primary  Disk  Retention 

The  following  are  parameters  used  to  define  disk  retention. 


Parameter 

Description 

DCOPIES=Mnnn« 

Specifies  the  number  of  copies  of  the  report  (0  to  32767)  to  be 
retained  on  disk  for  the  SYSOUT  ID 

DCOPIES  is  intended  to  be  specified  with  COPIES  to  limit  the 
number  retained  on  disk. 

DRETPD=nnnnn 

Specifies  the  number  of  days  (0  to  32767)  that  a  report  for  the 
SYSOUT  ID  is  retained  on  disk 

DRETPD  is  intended  to  be  specified  with  RETPD  to  limit  the 
number  retained  on  disk. 

The  DSK2DAYS  parameters  (initialization  parameter,  and 
ERO  table  parameter)  should  not  be  greater  than  DRETPD> 
because  if  a  report  is  deleted  from  primary  disk,  it  won't  be 
available  for  migration  to  optical  disk. 

DGENS=nnnnn 

Specifies  the  number  of  generations  (0  to  32767)  of  the 
CA-View  report  for  the  SYSOUT  ID  that  is  retained  on  disk 

DGENS  is  intended  to  be  specified  with  GENS  to  limit  the 
number  retained  on  disk. 

IRETPD=nnnnn 

Specifies  the  number  of  days  (0  to  32767)  that  any  page 
indexes  defined  for  the  reports  are  retained  on  disk 

Continued 
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Parameter  Description 

LRETPD=nnnnM  Specifies  the  number  of  days  (0  to  32767)  since  the  report  was 
last  accessed,  before  it  is  deleted  from  primary  disk 

The  DSK2DAYS  parameters  (initialization  parameter  and 
ERO  table  parameter)  should  not  be  greater  than  LRETPD, 
because  if  a  report  is  deleted  from  primary  disk,  it  won't  be 
available  for  migration  to  optical  disk. 

LRETPD  overrides  the  HOLDTEMP  initialization  parameter. 
HOLDTEMP  sets  a  global  default  for  the  number  of  backup 
cycles  to  occur  before  a  temporary  disk  report  (loaded  from 
tape  to  disk)  is  deleted. 


Disk  Retention  Parameter  Guidelines 


specifying  the  amount  of  retention  m  days  with  the  DRETPD  parameter  for  disk 
and  RETPD  parameter  for  tape  clarifies  the  effect  of  the  ERO  table  on  a  report's 
retention — it  willibe  kept  for  nn  days.  Specifying  the  DRETPD  parameter  is  the 
most  efficient  processing  method>  because  CA-View  can  use  a  simple  arithmetic 
calculation  on  the  archival  date. 

We  recommend  that  you  specify  the  following  disk  parameters  with  the 
corresponding  tape  retention: 


Disk  Retention 

Tape  Retention 

Parameter 

Parameter 

DRETPD 

RETPD 

DGOPIES 

COPIES 

DGENS 

GENS 

Note:  If  you  do  not  specify  a  disk  retention  parameter,  disk  retention  is  the  same 
as  the  tape  retention.  If  youi  specify  disk  retention,  but  not  tape  retention,  the 
PCOPIES  initialization  parameter  is  used  as  the  tape  retention. 
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Tape  Retention  Parameters 

We  recommend  that  you  specify  only  one  tape  retention  parameter  per  ERO  table 
statement. 


Tape  Retention 
Parameter 

Description 

COPIES=nnMnn 

Specifies  the  total  number  of  unique  copies  of  a  report  (0  to 
32767)  that  are  retained  on  tape  for  the  SYSOUT  ID 

RETPD=MnnMn 

Specifies  the  total  number  of  days  (0  to  32767)  that  a  report 
with  the  SYSOUT  ID  is  retained  on  tape 

GENS=nnMnM 

Specifies  the  total  number  of  CA-View  generations  (0  to 
32767)  that  a  report  with  the  SYSOUT  ID  is  retained  on  tape 

Tape  Retention  Parameter  Guidelines 

We  recommend  that  you  use  only  one  tape  retention  parameter  per  entry; 
however,  if  you  use  more  than  one  parameter,  each  parameter  must  be  satisfied 
before  a  SYSOUT  no  longer  has  expanded  retention  (PERM)  status.  For  example, 
suppose  you  have  COPIES=3  and  RETPD=30  for  a  SYSOUT  that  is  created  daily. 
All  copies  are  kept  for  30  days.  The  most  recent  three  copies  are  kept  indefinitely. 

When  the  tape  retention  criteria  are  satisfied,  the  SYSOUT  ID  is  no  longer  in 
expanded  status,  even  if  the  disk  retention  criteria  isn't  satisfied. 

Note:  If  no  ERO  tape  retention  is  specified  (COPIES,  RETPD,  GENS),  then  the 
initialization  parameter  PCOPIES  is  used  as  the  default. 


Tape  Location  (STORGRPx) 

STORGRPx  specifies  the  tape  storage  group  for  SYSOUT.  These  group  names  can 
be  esoteric — they  are  linked  to  STORGRPl  through  STORGRP9.  See  STORGRPl  - 
STORGRP9  in  Chapter  2,  "Initialization  Parameters." 

Syntax  STORGRPx=3’roup-naa2e 

If  you  use  the  expanded  access  server  for  tape  and  robotics,  you  should  consider 
grouping  reports  based  on  how  frequently  they  are  accessed  to  minimize  tape 
moimts  and  improve  performance.  You  can  also  choose  to  group  reports  by  their 
retention  requirements,,so  the  distribution  of  expired  reports  on  tape  is  less 
fragmented,  lessening  the  need  for  tape  consolidation. 
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We  recommend  that  you  assign  STORGRPl  the  group-name  with  the  largest 
number  of  reports  to  enhance  backup  cycle  performance.  You  use  the  SARINIT 
initialization  parameter  STORGRPl  to  assign  the  group,  for  example: 

STORGRPl=Iar^ast  -erroup-name 


Tape  Online  Access:  VIEWTAPE 

VIEWTAPE  specifies  whether  the  SYSOUT  can  be  viewed  if  it  resides  only  on 
tape. 

Syntax  viewtape=yes  |  no 


Optical  Disk  Migration:  DSK2DAYS 

DSK2DAYS  specifies  the  number  of  days  (1  to  998)  a  report  remains  on  primary 
disk  before  it  is  migrated  to  optical  (secondary)  disk. 

SyntOX  DSK2DAYS=imn 

Setting  the  value  to  0  specifies  that  SYSOUT  groups  be  migrated  to  optical  disk 
with  the  next  CA-View  backup  cycle,  scheduled  nm  of  the  optical  migration 
subtask,  or  optical  migration  batch  job.  Setting  the  value  to  999  specifies  that 
SYSOUT  groups  will  never  be  migrated  to  optical  disk. 

There  is  also  a  DSK2DAYS  initialization  parameter  that  sets  a  global  default 
value. 


Optical  Disk  Retention:  DSK2NOTP 

The  DSK2NOTP  parameter  specifies  that  once  a  report  resides  on  optical  disk  (if 
a  tape  backup  exists)  is  deleted  from  the  tape  backup. 

Syntax  dskznotp 

If  you  do  not  specify  this  parameter,  tape  backups  are  still  maintained.  If  you 
specify: 

DSK2nAYS=0 

DSK2NOTP 

and  a  report  recently  archived  to  the  CA-View  database  migrates  to  optical 
before  the  next  backup  cycle,  no  tape  backup  is  ever  created. 
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Exceptional  Condition  Processing 


The  XCOND  ke5rword  is  for  reports  cor^taining  JGL  MSGCLASS  data. 


Syntax 


XGOND={YESjNO} 


XGOND  allows  you  to  specify  whether  GA-View  should  consider  SYSOUTs  that 
had  exceptional  conditions,  for  example,  JGL  errors,  ABENDS,  etc.,  for  ERG) 
evaluation. 

YES  Specifies  that  the  report  is  selected  even  though  an  exception  is  present 

NO  Specifies  that  the  report  is  bypassed  for  ERO  processing  when  an 
exception  is  present 

You  can  set  the  ERO  initialization  parameter  PXGOND=:NO  to  bypass  JGL 
reports  containing  exceptional  conditions  for  the  entire  database.  You  can  set  the 
ERO  table  parameter  XGOND=NO  for  any  individual  table  entry,  and  any 
reports  governed  by  that  entry  wiU  be  bypassed  if  exceptional. 

Gonditional  selection  for  ERO  processing  can  be  further  refined  by  creating  user- 
defined  exceptional  conditions.  See  the  section  Exceptional  Gondition  Ghecking 
,  in  Ghapter  1,  "Introducing  GA-View." 


Excluding  Reports 


EXGLUDE  specifies  that  reports  matching  sysout-id-spec  on  this  entry  are 
bypassed  for  selection  for  ERO  processing. 

Syntax  exclude 


The  Keyword  DELETE 

DELETE  specifies  that  when  the  ERO  retention  TOTAL  criteria  expires,  the  report 
is  deleted  (instead  of  reverting  to  the  control  of  the  GA-View  initialization 
parameters  NGENT). 

Syntax  delete 

If  FRET ArN=T ABLE,  DELETE  is  not  required.  DELETE  does  not  affect  disk 
retention.  (When  disk  retention  criteria  expire,  the  SYSOUT  goes  to  initialization 
parameter  NGENT  control,  unless  PRETAIN=TABLE.) 
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If  you  set  the  initialization  parameter  PRETAIN=TABLE,  reports  are  deleted 
when  they  expire  from  the  table,  and  the  DELETE  parameter  is  not  necessary  We 
recommend  that  you  specify  PRETAIN=TABLE  to  make  the  ERO  table  a  single 
pomt-of-control.  ° 

If  you  specify  MAEJC,  (or  POPT.M),  marked  mports  wittbe  assigned  fee 
lelention  specified  in  fee  ERG  Table  entry.  Ummaiked  reports  are  considered 
ei^ired,  therefore,  they  are  deleted  during  the  first  standard  backup  cycle 
foUowmg  their  archival  to  CA-View. 

If  you  specify  LAST  (or  POPT=L),  the  last  report  in  the  generations  being 
processed  will  be  assigned  the  retention  specified  in  the  ERO  table  entry.  The 
copies  that  precede  the  last  copy  in  the  generations  being  processed  are 
considered  expired;  therefore,  they  are  deleted  during  the  first  standard  backup 
cycle  foUowmg  their  archival  to  CA-View. 


ERO  Table  Examples 


Example  1 


Example  2 


This  example  allows  you  to  keep  two  generations  of  all  CA-View  reports  on  disk 

also  governs  master  index  backups. 

Additionally,  you  can  keep  reports  beginning  with  the  characters  ABC  on  tape 
for  90  days,  but  limited  to  30  days  on  disk. 


Set  the  following  initialization  parameters: 


NGEND=2 

NGENT=3 


Specify  the  foUowmg  ERO  table: 

/ABC*  ALL  RETPDa90  DRETPD=30 

*  ALL  APPLICATION  'ABC'  KEPORTS  ARE 

*  ON  DISK  30  DAYS,  ON  TAPE  90  DAYS 


example  aUows  you  to  keep  all  reports  beginning  with  ABCD  on  disk  for  7 
S  °n  tape  for  one  year.  You  can  also  keep  reports  beginning  with  just 
ABC  on  disk  for  7  days,  and  on  tape  for  90  days. 

Set  the  foUowing  initiaUzation  parameters: 


/ABCD*  ALL  RETPDs366  DRETPD=7 

/ABC*  ALL  RETPD=90  DRETPD=7 
* 

*  ABCD  REPORTS  ARE  REQUIRED  ON  TAPE 

*  FOR  ONE  YEAR  FOR  LEGAL  PURPOSES 


Note:  ERO  uses  the  first  match  it  finds.  If  these  entries  were  in 
ABCD*  entry  would  never  be  used. 


reverse,  order  the 


6-10  CA-View  System  Reference  Guide 


Assigning  SYSOUT  IDs  Based  on  Embedded  Text 


Example  3 


Example  4 


Example  5 


This  example  allows  you  to  keep  report  ABCDE  contains  J€L  MSGCLASS  data.  It 
is  created  multiple  times  during  the  production  cycle.  You  want  the  last  report  in 
each  generation  that  ran  without  an  exceptional  condition  to  be  kept.  At  most,  10 
copies  will  be  kept  on  tape,  5  of  which  are  also  on  disk. 

Specify  the  following  ERO  table: 

/ABCDE  LAST  COPIES=10  DC0P1ES=5  XCOHD=NO 

This  example  allows  you  to  keep  disk  utilization  to  an  absolute  minimum.  All 
JGL  reports  beginning  with  the  characters  AUIDIT — including  runs  that  had 
exceptional  conditions,  will  be  kept  on  tape  for  seven  years.  No  copies  will  be 
kept  on  disk  past  the  current  generation. 

Set  the  following  initialization  parameters: 

PRETAIN=TABLE 

NGEHD=1 


Specify  the  following  ERO  table: 

/AUDIT*  ALL  BETPD=2557  DRETPD=0  XCOND=YES 

This  example  allows  you  to  keep  disk  utilization  to  an  absolute  minimum. 
Reports  beginning  with  the  characters  TEST  are  excluded  from  ERO  processing, 
A  user-defined  retention  of  3  days  is  established  for  aU  reports  that  are  marked 
(K  online  command,  SARBCH  /PERM  statement),  even  if  they  run  with  an 
exceptional  condition. 

Set  the  following  initialization  parameters: 

N6Ein}=l 

Specify  the  following  ERO  table: 

/TEST*  EXCLUDE 

/*  HARK  BETPD=3  XGONDsYES 


Assigning  SYSOUT  IDs  Based  on  Embedded  Text 

It  is  possible  to  have  ERO  assign  SYSOUT  IDs  based  on  text  within  a  report  itself. 
As  an  example,  you  could  give  compilation  listings  of  a  production  program!  a 
SYSOUT  ID  that  is  the  name  of  the  program.  To  do  this  you  specify  a  text  string 
to  be  found  in  the  report.  When  the  string  is  fotmd,  the  preceding  or  following 
characters  are  extracted  by  ERO  and  assigned  to  the  report  as  the  SYSOUT  ID; 
The  text  comprising  that  string  must  aU  be  on  one  line  of  the  report. 

You  can  define  up  to  five  separate  text  strings,  which  you  specify  as  initialization 
parameters  PTEXTl  through  PTEXT5. 
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CA-Deliver  reports  have  a  fixed  report  ID.  You  cannot  use  PTEXTn  to  change  the 
SYSOUT  ID  for  a  GA-Deliver  report. 

Text  Extraction  (+  and  -) 

Prefix  the  PTEXT  text  string  with  a  plus  or  minus  sign  to  indicate  if  the  SYSOUT 
ID  is  to  be  the  characters  to  the  right  of  the  PTEXT  (specified  with  a  +)  or  to  the 
left  (specified  with  a  -)..If  you  do  not  specify  plus  or  minus,  the  default  is  plus. 

The  characters  following  or  preceding  the  PTEXT  string  are  searched  for  the  first 
non-blank  valid  SYSOUT  ID  character.  Characters  are  extracted  until  an  invalid 
character  is  encountered  or  12  characters  are  obtained. 

PTEXTl- '  LOADI.1B  <  ' 

The  report  could  be  a  JCL  listing  containing  the  following: 

//SYSLMOD  DD  DSN=PRODiI.OADLIB(DEVWORK)  ,DISP=SHR 

The  extracted  SYSOUT  ID  is  DEVWORK. 


Segmented  PTEXT  Strings 

You  can  specify  a  series  of  text  strings  separated  by  periods,  referred  to  as 
segmented  text  strings.  1£  segmented  text  is  specified: 

■  The  report  is  scanned  until  the  first  segment  of  PTEXT  text  is  located,  then  it 
is  scanned  for  the  next  segment,  and  so  on,  until  the  last  segment  is  found: 

■  Each  text  segment  should  be  enclosed  m  single  quotation  marks.  Each  PTEXT 
specification  can  be  a  total  of  40  characters,  including  the  periods  that 
separate  the  segmented  text  strings.  Quotation  marks  that  enclose  the  text 
string  are  not  included  in  the  40  characters. 

For  the  specification 
PTEXT1=' SYSLMOD' . 'LOAD( ' 

when  the  following  JGIL  is  scanned: 

//LKEDi SYSLMOD  DD  DSN=PRODs.LOAD(PGMal30)  ,D1SP=SHR 

the  extracted  SYSOUT  ID  would  be  the  member  name,  PGMA130.  Notice  that  the 
text  segments  SYSEM0D  and  LOAD  are  enclosed  in  single  quotation  marks,  to 
show  that  the  period  is  a  segment  delimiter. 
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Special  Characters 

If  you  want  to  search  for  a  period  or  a  single  quote  mark,  use  double  quotation 
marks  as  the  delimiter.  For  example: 

PTEXT3  a: "  GRP  .  HTE  '  TRP  '  " 

CA-View  checks  the  PTEXT  entry  first  for  a  single  or  double  quotation  mark. 
Whichever  it  finds  first  is  taken  as  the  delimiter. 

The  report  is  a  compile  listing  containing; 

-PROGRAM- ID.  PROGRMl- 

The  specification 
PTEXT1=  “PROGRAM- IDi." 

causes  PROGRMl  to  be  the  extracted  SYSOUT  ID. 


PTEXT  in  the  SYSOUT  ID  Hierarchy 

The  following  list  shows  the  hierarchy  used  by  CA-View  and  ERO  to  determine 

the  SYSOUT  ID  for  a  report  other  than  a  CA-Deliver  report: 

■  If  the  started  task  user  exit  (SARSTCUX)  is  coded  to  assign  a  SYSOUT  ID  not 
equal  to  the  job  name,  that  SYSOUT  ID  is  used>  and  it  overrides  all  of  the 
following  items  in  this  list. 

■  If  SYSOUT  DD  statement  has  an  external  writer  name  not  equal  to  the  job 
name,  the  writer  name  is  assigned  as  the  SYSOUT  ID.  If  a  dollar  sign 
precedes  the  writer  name,  the  writer  name  (excluding  the  dollar  sign)  is 
appended  to  the  job  name,  and  the  result  is  assigned  as  the  SYSOUT  ID.  This 
overrides  all  of  the  following  items  in  this  list. 

■  If  the  text  specified  in  the  PTEXTl  through  PTEXT5  ERO  initialization 
parameters  is  found  in  the  report  data,  the  SYSOUT  ID  is  assigned  based  on 
characters  extracted  from  the  data. 

■  If  none  of  the  above  is  foimd,  the  job  name  of  the  job  that  creates  the  report  is 
the  SYSOUT  ID. 


Tape  Consolidation  of  Reports  (SARPAC) 

With  ERO  processing  it  is  possible  that  CA-View  backup  tapes  contain  reports 
that  expire  at  different  times.  For  any  particular  tape,  there  can  be  one  report  that 
has  ERO  retention  criteria  of  seven  years,  but  other  reports  on  the  tape  may  have 
expired.  The  space  occupied  by  these  reports  should  be  reused. 
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The  SARPAC  tape  consolidation  utility  is  provided  with  ERO  to  consolidate 
backup  tapes.  SARPAC  copies  cxirrent  reports  (still  retained  by  CA-View)  and 
bypasses  expired  reports.  The  first  CA-View  backup  cycle  (standard  or  interim) 
following  a  SARPAC  consolidation  uncatalogs  the  input  tapes  that  are  no  longer 
needed. 

You  can  use  SYSIN  DD  statements  to  process  the  following: 

■  All  backup  tapes  for  the  database 

■  A  particular  backup  tape  (by  CA-View  tape  sequence  number) 

■  A  range  of  tapes 

■  A  particular  tape  storage  group 

You  can  use  storage  groups  to  put  reports  with  the  same  retention  on  the  same 
tape,  there  by  minimizing  the  need  for  consolidation.  For  information  about  tape 
storage  groups,  see  STORGRPO  and  STORGRP1-STORGRP9  in  Chapter  2, 
"Initialization  Parameters 


Operation 


The  ERO  initialization  parameters  PTHRESH,  PMXT APES,  and  PMXYEARS 
control  which  tapes  will  be  consolidated  by  SARPAC.  The  following  table 
provides  a  description  of  each  of  these  parameters: 


ERO  Initialization 
Parameter 

Description 

PTHRESH 

Allows  you  to  specify  a  threshold  value  (for 
example,  only  consolidate  tapes  that  are  55 
percent  unused) 

PMXTAPES 

Allows  you  to  limit  the  SARPAC  run  by 
specifying  the  number  of  tapes  that  will  be 
processed 

PMXYEARS 

Allows  you  to  specify  how  long  a  tape  can 
exist  before  it  is  automatically  consolidated 
(which  is  important  because  tapes  tend  to  have 
I/O  problems  as  they  age) 

The  SYSIN  statements  can  also  specify  which  tapes  to  use  for  input  Additionally, 
you  can  modify  the  SARPACUX  user  exit  to  select  input  tapes  based  on  user- 
defined  criteria. 

SARPAC  does  not  use  the  expanded  access  server  for  tape  and  robotics  to  mount 
input  tapes;  SARPAC  mounts  its  input  tapes  directly. 
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SARPAC  Reports 

SARPAC  produces  two  reports.  The  first  report  lists  the  status  of  all  tapes  in  the 
database,  and  can  help  you  determine  whidi  tapes  need  to  be  consolidated.  The 
second  report  is  created  when  SARPAC  actually  performs  consolidation,  and  it 
lists  the  copied  SYSOUT  groups. 


Creating  the  Tape  Status  Report  Without  Running  Consolidation 

The  keyword  REPORT  can  be  coded  as  the  second  subparameter  of  the  PARM 
field  on  the  EXEC  statement: 

PAHM=  '  VIEW  .  SYSTEMl ,  REPORT  ' 

This  keyword  indicates  that  only  the  tape  status  report  is  produced  and  that  no 
actual  tape  consolidation  is  performed. 


SARPAC  Tape  Status  List 


The  following  is  a  sample  of  the  SARPAC  Tape  Status  List: 


02/29/96  14:30:08 

CA-VIEW  (2.0) 

PAGE  1 

,  SARPAC  EXPANDED  RETENTION 

OPTION  (ERO)  TAPE  CONSOLIDATION  - 

TAPE  STATUS 

LIST 

USED 

PER- 

TOTAL 

PROCESSED? 

TSEQ 

DATA  SET  NAME 

VOLSER 

TOTAL 

GRPS 

CENT  CREATE 

YRS 

DPLX 

LINES 

YES /NO,  REMARKS 

24 

VI EW . SYSTEMl , SARTAPE . TO  0 00  02 4 

461079 

22 

1 

4  02/07/96 

1 

YES 

11600 

Y, 

BELOW  PTHRESH 

28 

VIEW.SYSTEMl  .SaRTAPE.T0000028 

486037 

4 

3 

75  02/15/96 

1 

151200 

Y, 

BELOW  PTHRESH 

29 

VIEW, SYSTEMl .SARTAPE. T0000029 

486158 

1 

1 

100  02/15/96 

1 

126000 

Y, 

CONTINUATION  TAPE 

30 

VIEW. SYSTEMl .SARTAPE. T0000030 

486035 

3 

2 

66  02/15/96 

1 

YES 

25200 

Y, 

BELOW  PTHRESH 

35 

VIEW. SYSTEMl .SARTAPE. T0000035 

484885 

2 

2 

100  02/15/96 

1 

YES 

499747 

N, 

ABOVE  PTHRESH 

36 

VIEW. SYSTEMl . SARTAPE. T000003  6 

484351 

1 

1 

100  02/16/96 

1 

YES 

487147 

N, 

CONTINUATION  TAPE 

37 

VIEW , SYSTEMl . SARTAPE . TO  0  00  0  3  7 

486050 

1 

1 

100  02/16/96 

1 

YES 

487147 

N, 

CONTINUATION  TAPE 

38 

VIEW . SYSTEMl . SARTAPE .T0000038 

484426 

4 

3 

75  02/16/96 

1 

YES 

511347 

Y, 

BELOW  PTHRESH 

41 

VIEW . SYSTEMl . SARTAPE .T0000041 

468007 

2 

0 

0  02/28/96 

1 

0 

N, 

NO  USED  GROUPS 

42 

VIEW ,  SYSTEMl . SARTAPE .T0000042 

479554 

1 

0 

0  02/28/96 

1 

0 

N, 

NO  USED  GROUPS 

43 

VIEW .  SYSTEMl . SARTAPE .T0000043 

474440 

1 

0 

0  02/28/96 

1 

0 

N, 

NO  USED  GROUPS 

44 

VIEW . SYSTEMl , SARTAPE .T0000044 

479202 

1 

0 

0  02/28/96 

1 

0 

N, 

NO  USED  GROUPS 

45 

VIEW. SYSTEMl , SARTAPE . T0000045 

427576 

1 

0 

0  02/28/96 

1 

0 

N, 

NO  USED  GROUPS 

46 

VI EW . SYSTEMl . SARTAPE , TO  0  0  0  0  4  6 

428393 

0 

0 

02/28/96 

1 

0 

N, 

NO  USED  GROUPS 

47 

VI EW . SYSTEMl . SARTAPE .T0000047 

428119 

7 

6 

85  02/28/96 

1 

75600 

N, 

CURRENT  BACKUP 

SARPAC  Tape  Status  List:  Fields 

The  following  fields  are  provided  in  the  report: 

■  Tape  sequence  numbers  by  which  CA-View  references  the  tapes 

■  Data  set  name 

■  Volume  serial  number 

■  Total  SYSOUT  groups  that  have  been  archived 

■  Number  of  SYSOUT  groups  still  in  use 

■  Percentage  of  the  SYSOUT  groups  still  in  use 
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SARPAC  Reports 


■  Creation  date 

■  Number  of  years  (rounded  up)  since  the  tape  was  created 

■  Whether  a  duplex  tape  exists 

■  Total  number  of  lines  for  the  SYSOUT  group 

■  Whether  the  tape  was  processed  by  SARPAC  and  the  corresponding  remarks 


Remarks  Field  of  Tape  Status  List 

The  following  list  explains  the  remarks  in  the  PROCESSED  YES/NO;  REMARKS 
field  of  the  Tape  Status  List: 


Remark 

Description 

Y,  BELOW  PTHRESH  % 

Indicates  the  below  PTHRESH  initialization 
parameter  percentage 

Y,  CONTINUATION  TAPE 

Indicates  that  the  tape  will  be  moimted  only  to 
retrieve  the  remaining  part  of  a  continued  report 

Y,  EXCEEDS  PMXYEARS 

Indicates  that  the  PMXYEARS  imtialization 
parameter  was  exceeded 

Y,  EXIT  SELECTED 

Indicates  that  the  tape  was  marked  for  selection  by 
the  user  exit  SARPACUX 

Y,  MERGED  DATABASE 

Indicates  that  the  tape  belongs  to  a  merged  database 

Y,  SYSIN  INCLUDED 

Indicates  that  the  tape  has  been  selected  for 
processing  and  that  the  tape  sequence  number  is 
within  the  range  specified 

N,  ABOVE  PTHRESH  % 

Indicates  the  above  PTHRESH  initialization 
parameter  percentage 

N,  CURRENT  BACKUP 

Indicates  that  the  current  tape  is  never  processed 

N,  EXCEEDS  PMXTAPES 

Indicates  that  the  PMXTAPES  initialization 
parameter  was  exceeded 

N,  EXIT  EXCLUDED 

Indicates  that  the  tape  was  marked  for  exclusion  by 
exit  SARPACUX 

N,  NO  USED  GROUPS 

Indicates  that  there  are  no  reports  on  the  tape  to 
copy 

Continued 
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Continued 

Remark 

Description 

N,  CONTINUATION 
TAPE 

Indicates  that  the  tape  only  contains  a  report  that  is 
continued  from  a  previous  tape,  and  that  the  tape  is 
not  being  processed 

N,  SYSIN  EXCLUDED 

Indicates  that  the  tape  sequence  number  was  not 
within  the  specified  range 

SARPAC  Copied  SYSOUT  Groups  Report 


The  second  report  lists  the  copied  SYSOUT  groups.  The  following  is  a  sample  of 
the  SARPAC  Copied  SYSOUT  Groups  Report: 


02/29/96  14:30:11  CA-VIEW  (2.0) 

SARPAC  EXPANDED  RETENTION  OPTION  (ERO)  TAPE  CONSOLIDATION  -  COPIED  SYSOUT  GROUPS 

ID  JOBNAME  JOBID  GEN  SEQ  ARC  DATE/TIME  XCODE  LOC  LINES  PAGES  BLOCKS  TVSER  DUPLEX  TSEQ 


REPORTl 

COOCH03A  JOB03282 

21 

12 

02/13/96 

17:03 

REPORTl 

COOCH03A  JOB05650 

23 

6 

02/15/96 

19:25 

REPORTl 

COOCH03A  JOB05651 

23 

7 

02/15/96 

19:30 

REPORTl 

COOCH03A  JOB05649 

23 

8 

02/15/96 

19:30 

REPORTl 

COOCH03A  JOB05747 

23 

9 

02/15/96 

21:28 

REPORTl 

COOCH03A, JOEOS748 

23 

10 

02/15/96 

21:33 

REPORTl 

COOCH03B  JOB05783 

23 

12 

02/15/96 

22:00 

REPORTl 

COOCH03A  JOB03455 

23 

1 

02/13/96 

21:23 

SARPACll 

0000008  SYSOUT  GROUPS 

COPIED 

PTAP 

11600 

200 

8 

428029 

48 

PTAP 

12600 

200 

33 

428029 

48 

PTAP 

12600 

200 

33 

428029 

48 

PTAP 

126000 

2000 

319 

428029 

48 

PTAP 

12600 

200 

33 

428029 

48 

PTAP 

12600 

200 

33 

427770 

49 

PTAP 

12600 

200 

33 

427770 

49 

PTAP 

11600 

200 

8 

427770 

49 

SARPAC  Copied  SYSOUT  Groups  Report:  Fields 


The  following  fields  are  provided  in  the  report. 

■  SYSOUT  identifiers 

■  Name  of  the  job  that  created  the  SYSOUT 

■  JOBID  of  the  job  that  created  the  SYSOUT 

■  Archival  generation  number 

■  SYSOUT  sequence  number  for  the  generation 

■  Archival  date  and  time 

■  Last  print  date  and  time 

■  Location  of  the  SYSOUT  group 

■  Number  of  lines 

■  Number  of  pages 

■  Number  of  blocks  on  tape  for  the  report,  any  indices  it  may  have,  and 
mapping  information 


1  ! 
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■  Exception  conditioni 

■  Volume  serial  numbers  of  the  output  tape,  if  duplexing  is  being  done 

■  Tape  sequence  number  by  which  CA-View  references  the  output  tape 


Running  SARPAC 

This  section  explains  how  to  execute  SARPAC  and  provides  examples  for  setting 
initialization  parameters,  consolidating  the  tape  storage  group,  and  consolidating 
one  tape  for  a  tape  storage  group. 


Job  Control  Statements 

The  following  job  control  statements  are  required  to  execute  SARPAC: 


Control  Statement 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARPAC)  and  the 
high-level  name  of  the  CA-View  database  as  the  PARM 
parameter  (PARM='VIEW.SYSTEM10 

STEPEIBDD 

Defines  the  load  library  containing  SARPAC 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRINTDD 

Defines  the  sequential  output  data  set  (normally  SYSOUT) 
used  for  listing  the  consolidation  report 

If  there  is  no  SYSOUT  data  set,  DCB=BLKSIZE=Mnn  must 
be  coded  where  nnn  is  a  multiple  of  121. 

SYSINDD 

Optional,  specifies  input 

See  the  following  section.  Input  to  SARPAC,  for  details. 

Input  to  SARPAC 


You  can  specify  the  following  as  input  to  SARPAC: 

■  A  single  tape  by  its  CA-View  tape  sequence  number 
TAPESEQannnnn 

■  A  range  of  tapes  by  their  CA-View  tape  sequence  numbers 

TAPESEQ=nnnrm- nnnnn 


6-18  CA-View  System  Reference  Guide 


Running  SARPAC 


■  A  tape  storage  group  by  its  name 
STO'RGRP=sto3:aga-gjroiip~name 

The  keyword  DEFAULT  is  the  name  of  the  default  storage  group. 

When  only  one  storage  group  is  specified,  the  initialization  parameters 
PTHRESH,  PMXTAPES,  and  PMXYEARS  are  used. 

When  only  one  tape  sequence  number  (or  range)  is  specified,  the  tape  is 
processed  whether  it  meets  PTHRESH  or  PMXTAPES  requirements. 

When  both  a  storage  group  and  tape  sequence  number  (or  range)  are  specified, 
only  reports  that  belong  to  the  tape  storage  group,  and  are  within  the  tape 
sequence  range,  are  processed. 

You  can  specify  only  one  of  each  type  of  SYSIN  statement  (STORGRP  and 
TAPESEQ). 


Concurrent  With  Archival 

It  is  not  necessary  to  stop  the  SARSTC  archival  task  to  nin  the  SARPAG  utility. 
Consolidation  can  occur  concurrently  with  report  archival  and  the  CA^-View 
backup  cycle. 


Canceling  SARPAC 

If  you  have  a  tape  management  system  and  you  cancel  SARPAC,  CA-View's  tape 
retention  criteria  may  be  overridden  by  your  tape  management  system;  therefore, 
you  should  always  allow  SARPAC  to  nm  to  completion! 

If  you  must  cancel  SARPAC,  any  output  tapes  it  created  must  be  excluded  from  a 
scratch  and  clean  run,  because  GA-View  still  controls  those  tapes.  You  may  run 
the  SARTCHK  utility  to  determine  if  any  tapes  were  uncataloged  that  are  still 
required  by  CA-View. 


Consolidating  Tape  Storage  Groups 

If  you  use  tape  storage  groups,  we  recommend  that  you  consolidate  one  tape 
storage  group  at  a  time  to  decrease  the  number  of  tape  moxmts  needed  by  issuing 
the  foUbwing  SYSIN  DD  statement; 

ST0R6RP= s  t  orasre -group-name 

Note:  You  must  run  a  standard  or  interim  backup  cycle  to  assign  reports  to  tape 
storage  groups.  Storage  groups  are  only  in  effect  for  reports  residing  on  the 
CA-View  database  since  the  last  backup  cycle. 
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For  information  about  tape  storage  groups,  see  STOR<SRPO  and  STORGRPl  to 
STORGRP9  in  Chapter  2,  "Ihitialization  Parameters." 


Example  1 :  Using  Initialization  Parameter  Settings 

Alii  eligible  tapes  (given  the  values  for  PTHRESH>  PMXT APES,  and  PMXYEARS) 
are  consolidated  for  database  VIEW.SYSTEM1: 

//EXAMPLE  JOB  ACCOUNT, PROGRAMMER 

//SARPAC  EXEC  PGM=SARPAC, PARM= ' VIEW. SYSTEMl ' 

//STEPLIB  DD  DSN=CAI.CAILIB,DISP=SHR 

//SYSPRINT  DD  SYSOUT=* 

//*SYSIN  DD  * 


Example  2:  Consolidating  a  Tape  Storage  Group 


The  SYSIN  DD  consolidates  only  the  tape  storage  group  PAYROLL  for  database 
VIEW.SYSTEM1: 

//EXAMPLE  JOB  ACCOUNT, PROGRAMMER 
/ /SARPAC  EXEC  PGM=SARPAC , PARM= ' VIEW . SYSTEMl ' 

//STEPLIB  DD  DSM=CAI.CAILIB,DISP=SHR 

//SYSPRINT  DD  SYS0UT=* 

//SYSIN  DD  * 

STORGRP=PAYROLL 

//* 


Example  3;  Consolidating  One  Tape  of  a  Tape  Storage  Group 

The  SYSIN  DD  consolidates  only  tape  number  1156  for  the  tape  storage  group 
PAYROLL  for  database  VIEW.SYSTEM1; 

//EXAMPLE  JOB  ACCOUNT, PROGRAMMER 
/ /SARPAC  EXEC  PGM=SARPAC , PARM= '  VIEW . SYSTEMl ' 

//STEPLIB  DD  DSN=CAI.CAILIB,DISP=:SHR 

//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

STORGRP=PAYROLL 

TAPESEQ=1156 

//* 


1 
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Chapter  7 
Database  Utilities 


In  This  Chapter 

This  chapter  describes,  in  detail,  each  of  the  CA-View  database  utilities 
summarized  in  the  following  section. 


Summary  of  Utilities 

Creation  and  maintenance  functions  are  performed  using  the  SARDBASE, 

SARRCOV  (for  recovery),  and  SARRSP  utilities. 

■  SARDBASE  perfoims  database  maintenance  such  as  adding  space  to  a 
database  and  creating  and  deleting  a  database. 

■  SARRCOV  creates  a  recovery  file  that  includes  data  such  as  tape  volume 
serial  number  and  data  set  name. 

■  SARRSP  restores  panels,  messages,  and  SYSOUTs  to  a  disk  database  from 
tape  backups. 

Tape  maintenance  fxmctions  are  performed  using  the  SARTCP,  SARTCHK, 

SARTDR,  and  SARTSLST  utilities. 

■  SARTCP  maps,  copies,  or  salvages  SYSOUTs  on  backup  tapes. 

■  SARTCHK  verifies  that  every  active  CA-View  backup  tape  is  still  cataloged, 
and  lists  any  imcataloged  active  tapes. 

■  SARTDR  re-creates  and  re-loads  archival  disk  generations  from  tape. 

■  SARTSLST  checks  the  disk  database  and  lists  the  reports  that  were  on  that 
tape  when  a  tape  is  lost  or  damaged. 

The  SARSAM  utility  allows  user-defined  programs  to  directly  retrieve  index, 

SYSOUT,  and  panel  data  from  the  CA-View  database. 
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Database  Maintenance  With  SARDBASE 

The  SARDBASE  utility  defines  and  maintains  the  GA-View  database.  This  utility 
performs  the  following  functions: 

■  Defines  a  new  database 

■  Adds  additional  space  to  a  database 

■  Copies  a  database 

■  Renames  a  database 

■  Deletes  a  database 

■  Provides  usage  statistics  on  a  database 

■  Loads  the  online  library  to  a  database 

■  Produces  a  sequential  copy  of  a  master  index 

■  Recovers  a  database 

■  Unloads  a  database  to  a  sequential  data  set 

■  Loads  a  database  from  a  sequential  data  set 

■  Reorganizes  the  index  in  a  database 

■  Verifies  data  in  and  corrects  problems  with  a  database 

■  Defines  and  maintains  a  lock  file 

■  Merges  xmloaded  databases 

■  Sets  the  version  number  of  a  database 


Lock  File 

A  lock  file  is  a  mechanism  that  CA-View  provides  that  can  ensure  database 
serialization  in  envirorunents  where  hardware  reserve/ releases  cannot  be  used. 

One  example  of  an  environment  where  a  lock  file  can  be  used  to  ensxure  database 
serialization  is  in  a  situation  where  multiple  CPUs  are  running  under  VM. 
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Job  Control  Statements 

The  following  job  control  statements  are  required  to  execute  SARDBASE: 


Control  Stcitement 

Description 

JOB 

Initiates  the  job 

EXEG 

Specifies  the  program  name  (PGM=SARDBASE)  and 
optionally,  the  high-level  name  of  the  CA-View  database 
as  the  FARM  parameter  (PARM='VIEW.SYSTEM1') 

STEPLIB  DD 

Defines  the  load  library  containing  SARDBASE 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRINTDD 

Defines  the  sequential  output  data  set  (normally 

SYSOUT)  used  for  listing  the  control  statements  and 
messages 

If  not  a  SYSOUT  data  set,  DCB=BLKSIZE=nnn  must  be 
coded  where  nnn  is  a  multiple  of  121. 

SARIOUT  DD 

Defines  a  sequential  output  data  set  into  which  the 
master  index  is  unloaded 

The  attributes  of  the  data  set  will  be  set  to  RECFM=VB, 
LRECL=1028,  and  BLKSIZE=6133.  The  DD  statement  is 
only  required  for  an  IDXOUT  operation. 

SAROLIBDD 

Defines  the  ordine  library  containing  the  panel,  message, 
and  skeleton  JGL  members  to  be  loaded  to  the  database 

The  DD  statement  is  only  required  for  an  OLOAD 
operation. 

SARRECV  DD 

Defines  the  recovery  file 

This  statement  is  only  used  for  a  RESTORE  operation. 
While  this  DD  statement  is  optional,  it  should  be 
included  for  a  more  efficient  RESTORE  operation. 

Continued 
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Control  Statement 

Description 

SARTAPE  DD 

Defines  the  tape  containing  the  backup  of  the  master 
index 

This  statement  is  only  used  for  a  RESTORE  operation.  For 
a  RESTORE  operation,  the  DD  statement  is  optional  and 
is  only  used  when  there  is  no  recovery  data  set  or  the 
SARRECV  DD  statement  is  missing.  When  used,  the  file 
sequence  number  of  the  LABEL  parameter  must  specify 
the  position  number  of  the  master  index  backup  on  the 
tape.  The  position  of  the  backup  can  be  obtained  by 
mapping  the  tape  with  the  SARTCP  program. 

SARLOADDD 

Defines  the  device  containing  the  unloaded  database 

This  statement  is  orJy  used  for  a  LOAD  operation. 

SARUNLDDD 

Defines  the  device  to  which  the  database  is  unloaded 

This  statement  is  only  used  for  an  UNLOAD  operation. 

SARMERGmDD 

Defines  the  imloaded  databases  to  be  merged  together 

Replace  n  with  a  number  from  1-9  so  that  each  rmloaded 
database  is  defined  with  a  unique  DD  statement.  These 
statements  are  ordy  used  for  a  MERGE  operation. 

SYSINDD 

Defines  a  card  image  data  set  containing  the  control 
statements  to  be  input 

SARDBASE  Control  Statements 

Control  statements  have  the  following  general  syntax: 

Syntax  OPERATION  operands 

■  A  control  statement  must  be  coded  on  a  single  card  image  between  columns  1 
and  71.  The  operation  can  begin  in  column  1  or  may  be  preceded  by  one  or 
more  blanks. 

■  The  operation  and  the  first  operand  as  well  as  individual  operands  are 
separated  by  one  or  more  blanks. 

■  Comments  can  be  included  in  the  control  statements  by  coding  an  asterisk  in 
column  1  of  the  card  image  containing  the  comment. 
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ADDDS 


Syntax 


The  ADDDS  control  statement  is  used  to  create  a  new  database  or  to  add 
additional  space  to  an  existing  database.  Space  is  added  by  creating  a  new  data 
set  and  formatting  it  with  fixed-length  blocks. 

The  high-level  name  of  the  database  must  have  previously  been  defined  with  the 
NAME  control  statement  (or  the  PAEM  parameter  of  the  EXEC  JGL  statement). 

ADDDS  BLKSIZE= 

GYL1NDER= 

DATACLAS= 

MGHTCrj^S= 

STORGLAS= 

U1J1T= 

VOLSER= 

where: 


BLKSIZE= 


CYLINDER= 


DATACLAS= 

MGMTCLAS= 

STORCLAS= 

UNIT= 


VOLSER= 


Specifies  the  block  size  to  be  used  in  the  data  sets 

The  minimum  is  3476  (the  default);  the  maximum  is  16383. 
The  block  size  for  an  existing  database  cannot  be  changed,  so 
this  operand  is  only  valid  when  you  create  a  new  database. 
After  a  database  has  been  created,  any  subsequent  use  of  the 
block  size  parameter  is  ignored. 

See  the  section  Estimating  DASD  Requirements  For  a 
Database  later  in  this  chapter  for  information  about 
determining  the  block  size  you  should  use. 

Specifies  the  number  of  contiguous  cylinders  to  allocate  to 
the  data  set 

Specifies  the  data  class  of  an  SMS  data  set 

Specifies  the  management  class  of  an  SMS  data  set 

Specifies  the  storage  class  of  an  SMS  data  set 

Specifies  the  unit  name  to  be  used  to  dynamically  allocate  a 
new  data  set 

Specifies  the  volume  serial  number  on  which  to  allocate  the 
new  data  set 


All  of  the  ADDDS  keywords  can  be  abbreviated  to  the  fewest  number  of 
characters  that  makes  them  unique. 
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SMS  and  Non-SMS; 

Specifying 

Parameters 


Estimating  DASD 
Requirements  for  a 
Database 


The  following  table  svtmmarizes  the  interdependency  of  the  ADDDS  parameters 
for  SMS  and  non-SMS  data  sets: 


Parameter 

Non-SMS  Data  Set 

SMS  Data  Set 

BLKSIZE 

Optional 

Optional 

CYLINDER 

Required 

Required 

DATACLAS 

Omit 

Optional 

MGMTCLAS 

Omit 

Optional 

STORCLAS 

Omit 

Optional 

UNIT 

Optional 

Omit 

VOLSER 

Optional 

Omit 

There  is  no  way  to  know  the  exact  amount  of  space  that  will  be  required  for  a 

database.  The  following  can  be  used  to  approximate  the  space  needed  (for  this 

approximation,  a  block  size  of  3476  is  used): 

■  CA-View  writes  fixed-length  blocks  of  3476  bytes  to  its  database.  (This  is  the 
default.  You  can  specify  a  block  size  between  3476  and  16383.) 

■  190  blocks  are  contained  in  one  cylinder  of  a  3390, 180  blocks  are  contained  in 
one  cylinder  of  a  3380,  and  150  blocks  are  contained  in  one  3350  cylinder. 

■  Repetitive  characters  are  compressed,  giving,  on  the  average,  a  60  to  70 
percent  reduction  in  space  requirements. 

■  The  space  required  for  the  master  index  is  minimal  compared  to  the  space 
required  for  the  SYSOUT  data;  a  minimum  of  one  cylinder  is  required  for  the 
master  index. 

Using  the  previous  information,  the  amoimt  of  space  required  for  your  database 

can  be  approximated  using  the  following  steps: 

1.  Take  the  maximum  lines  archived  to  disk  in  one  generation  (that  is,  one  day). 

2.  Multiply  the  number  of  lines  by  the  average  line  length. 

3.  Divide  by  3  (for  compression). 

4.  Divide  by  3476  to  get  number  of  blocks. 

5.  Divide  by  190  (for  a  3390)  or  180  (for  a  3380)  or  150  (for  a  3350)  to  get  number 
of  cylinders. 
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ADDLOCK 


Syntax 


6.  Multiply  the  result  by  the  number  of  generations  to  be  retained  on  disk. 

7.  To  allow  for  growtii,  add  10  percent  to  the  resulti 

For  example,  assiome  tihat  a  site  produces  1,000,000  lines  of  SYSOUT  in  one  day  to 
be  archived  on  disk.  The  average  line  length  of  the  SYSOUT  is  121  bytes,  and  they 
will  keep  3  days  worth  of  SYSOUT  on  disk. 

Using  the  method  described  on  the  previous  page,  their  space  requirements  can 
be  approximated  as  follows: 

■  1,000,000  lines  (per  generation) 

■  1,000,000  lines  *  121  b5rtes/line  =  121,000,000  bytes 

■  121,000,000  bytes  /  3  =  40,333,333  bytes  (compressed) 

■  40,333,333  bytes  /  3476  bytes /block  -  11,603  blocks 

A  block  si2e  of  3476  is  assumed  for  this  example.  Consult  your  DASD 
administrator  to  choose  an  optimal  block  size. 

■  11,603  blocks  /  180  3380-cylinders  =  64  3380-cylinders 

■  64  3380-cylinders  *  3  generations  =  192  3380-cylinders 

■  192  3380-cylinders  +  19  3380-cylinders  (10%)  =  211  3380-cylinders 


The  ADDLOCK  control  statement  is  used  to  create  and  format  the  one-track  lock 
data  set  (lock  file)  which  will  be  used  to  serialize  CA-View  database  access. 

CA-View  perfonns  a  considerable  amoimt  of  I/O  to  the  CA-View  database;  it  is 
critical  to  the  integrity  of  the  database  that  all  concurrent  output  operations  be 
synchronized.  The  MVS  hardware  reserve /release  is  normally  used  to 
synchrorvize  access,  but  in  certain  environments  (such  as  a  multi-CPU  VM  site) 
this  is  not  insured.  The  lock  data  set,  in  these  cases,  will  function  as  a  substitute 
for  a  hardware  reserve /release  mechanism. 

The  high-level-name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement).  The 
database  must  also  have  been  created  via  the  ADDDS  control  statements 

AJDDIiOCK  unit  volume 
where: 

unit  Specifies  the  imit  name  where  the  lock.data  set  is  created 

volume  Specifies  the  volume  serial  where  the  lock  data  set  is  created 
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All  operands  for  the  ADDLOCK  control  statement  are  required. 


Warning!  Seriah/Jtion  \  la  tin  J(x  k  data  ‘*el  tan  dt.i;raJL  pi-rliirniarKt  m  iht- 
CA-View  database.  . 


COPY 


Syntax 


The  COPY  control  statement  is  used  to  copy  a  database.  The  output  database 
should  be  a  newly  created,  empty  database. 

The  high-level  name  of  the  output  database  must  have  been  defined  with  the 
NAME  control  statement  (or  the  PAJRM  parameter  of  the  EXEC  JCE  statement). 

COPY  from-name  reserve-option  buffer-option 
where: 


from-name 


reserve-option 


buffer-option 


Specifies  the  high-level  name  of  the  database  to  be  copied 
This  operand  is  required. 

Specifies  either  RESERVE  to  place  a  reserve  on  the  output 
database  for  the  duration  of  ^e  copy  operation  or  NORESERVE 
to  not  place  a  reserve  on  the  output  database 

Specify  NORESERVE  only  if  you  can  be  certain  that  no  one  else 
is  updating  the  output  database  while  the  COPY  operation  is 
proceeding.  If  omitted,  RESERVE  is  assumed. 

Specifies  either  BUFFER,  to  buffer  records  written  to  the  output 
database  which  improves  performance  and  reduces  I/O  time,  or 
NOBUFFER  to  eliminate  buffering 

If  omitted,  NOBUFFER  is  assumed. 


Warning!  \\htnusjn:;tht COP'i  control stilemmt  tdh'u  totin  Jillmim., 
1  Th-  (  \  \  lew  irehudl  started  task  should  be  uiirtue 
Z  111  destination  dcitobasi  should  be iiev\  and  unusvd 
3.  When  using  RUFFKR,  an  unsuccessful  complelK'n  could  i  c>rrupt  the 
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DELETE 

Syntax 

IDXOUT 

Syntax 

LOAD 


Syntax 


The  DELETE  control  statement  deletes  a  database. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 


delete  [LOCK] 


Optionally,  LOCK  can  be  specified  to  delete  the  database  lock  data  set  and 
resume  normal  MVS  Reserve/Release  access  to  the  database. 

Note:  The  DELETE  control  statement,  without  the  LOCK  parameter,  deletes  and 
imcatalogs  aU  data  sets  for  the  database  as  well  as  the  lock  data  set  if  it  exists. 


The  IDXOLTT  control  statement  is  used  to  write  the  master  index  for  the  database 
to  a  sequential  data  set.  The  sequential  output  data  set  is  defined  by  DD 
statement  SARIOUT. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 

XDXOX7T 


The  LOAD  control  statement  is  used  for  recovery  purposes  to  load  the  CA-View 
database  from  a  sequential;  previously  unloaded  Me.  The  input,  unloaded  copy 
of  the  database  is  defined  with  the  SARLOAD  DD  statement. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement).  If  the 
database  is  an  existing  database  containing  data,  the  records  will  be  added  to  the 
records  already  contained  in  the  database,  duplicate  records  will  be  replaced. 

LOAD  [BUFFER  |  NOBUFFER] 

BUFFER  specifies  whether  to  buffer  records  written  to  the  output  database, 
which  improves  performance  and  reduces  I/O  time.  NOBUE^R  is  the  default. 


Database  Utilities  7-9 


SARDBASE  Control  Statements 


'■  } 

-sr  :  ..  .  .  .  .  -  .  ■ 

Warning!  V\hfnus.ini;tht  U^\ULontiolsUitcmL«nt  adht'C  to  tiv  tnlJiu.um 
]  The  C  A-\  lew  ctrJiw  al  started  task  should  be  inacti\  c 
2  Tilt  destination  database  should  he  now  and  unused 
s  Ulien  usin^  BUFT-El?,  an  unsucsesstnl  eoinpletion  lould  eonupt  tht 


MERGE 


Syntax 


Because  the  SARPAG  tape  consolidation  utility  is  required  to  complete  the  merge 
process,  you  must  have  installed  the  Expanded  Retention  Option  (ERO): 

The  MERGE  control  statement  is  used  to  merge  1-9  existing  CA-View  databases 
together  into  one  new  database.  Logic  is  included  to  reset  generation  and  tape 
sequence  numbers  to  eliminate  any  conflicts  between  the  input  databases.  The 
output  database  should  be  a  newly-created,  empty  database. 

The  high-level  name  of  the  output  database  must  have  previously  been  defined 
with  the  NAME  control  statement  (or  the  FARM  parameter  of  the  EXEC  JGL 
statement). 

MERGE  tape-index  driver  parameters 
where: 


tape-index  Specifies  the  high-level  naming  prefix  to  be  set  for  the  TAPEIDX 
initialization  parameter 

If  omitted,  TAPEIDX  is  set  to  the  high-level  name  of  the  output  database. 

To  prevent  conflicts  with  any  existing  archival  tapes,  MERGE  requires 
that  this  high-level  naming  prefix  for  tapes  be  different  from  those  for 
any  tapes  defined  in  the  input  databases. 

driver  Specifies  the  name  of  the  secondary  disk  storage  driver  and  must  be  the 
same  as  the  DSK2DRVR  initialization  parameter 

You  should  use  driver  only  if  you  have  purchased  an  optical  disk 
secondary  storage  driver.  For  more  information,  see  Chapter  10;  "Using 
the  Optical  Disk  Interface." 

parameters  Specifies  the  identifiers  for  the  secondary  disk  storage  driver  as  defined 
by  the  DSK2PARM  initialization  parameter 

Use  parameters  only  if  you  have  an  optical  disk  secondary  storage 
driver.  These  parameters  vary  according  to  type  of  optical  disk  driver. 
For  the  proper  identifiers,,see  Chapter  10;  "Using  the  Optical  Disk 
Interface."  Parameters  are  required  when  you  specify  a  driver  name. 
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Merge  Process 


Common  information 
Between  Databases 


Why  You  Must  Run 
SARPAC 


Unloaded  copies  of  the  databases  that  are  merged  are  defined  in  the  JGL  with  DD 
statements  named  SARMERGm,  where  n  specifies  a  number  from  1—9.  The  first 
rmloaded  database  that  is  merged  is  defined  with  the  DD  statement  SARMERGl, 
the  second  with  DD  statement  SARMERG2,  and  so  on.  When  only  one  database  is 
merged,  the  operation  functions  as  a  reset  operation  to  reset  generation  and  tape 
sequence  numbers. 

When  performing  a  merge  operation,  the  following  steps  must  be  performed  in  the 
following  order: 

1.  Terminate  all  activity  against  the  databases  to  be  merged.  Be  sure  to  stop  all 
direct-to-CA-View  archival  activity  from  the  CA-Deliver  product. 

2.  Unload  the  databases  using  the  UNLOAD  function  of  this  utility. 

3.  Define  a  new  CA-View  database  (large  enough  to  hold  all  the  data  from  the 
input  databases)  using  the  ADDDS  function  of  this  utility. 

4.  Perform  the  merge  function. 

The  input  unloaded  databases  are  processed  twice.  The  first  time,  they  are 
scanned  to  determine  how  the  reset  of  generation  and  tape  sequence 
numbers  is  done;  the  second  time,  they  are  actually  loaded  to  the  new,  output 
database. 

5.  Verify  the  successful  completion  of  the  merge  function. 

6.  Run  SARINIT  to  review  add/ or  change  any  initialization  parameters  in  the 
merged  database. 

7.  Rtm  the  SARPAG  tape  consolidation  utility  as  many  times  as  necessary  to 
copy  all  the  archival  tapes  to  new  tapes  owned  by  the  merged  database. 

After  you  complete  Step  6,  the  newly-created,  merged  database  can  be  used  in 
production.  Step  7  can  be  run  while  the  database  is  being  used  in  production. 

The  follbwing  actions  occur  with  a  MERGE: 

■  For  any  common  definitions  in  the  input  database  (such  as  options  and  panel 
definitions),  only  the  definition  from  the  last  database  to  be  merged  is  used. 

■  Multiple  Define  SYSOUT  definitions  for  the  same  SYSOUT  identifiers  are 
merged. 

■  Multiple  Define  DISTMIBUTION  definitions  for  the  same  SYSOUT  identifiers 
are  merged. 

■  All  PC-transmitted  queue  entries  are  deleted  from  the  output,  merged 
database. 


Although  definitions  of  the  archival  tapes  from  the  input  databases  are  copied  to 
the  output  merged  database,  ownership  of  the  tapes  remains  with  the  input 
databases.  Therefore,  SARPAC  tape  consolidations  mustbenm  to  copy  the  tape 
archival  data  to  new  tapes  owned  by  the  new,  merged  database. 
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After  the  archival  tape  data  has  been  copied  using  the  SARFAG  utility,  references 
to  the  original  tapes  are  removed  from  the  merged  database  at  the  next  backup  or 
clean  cycle.  Only  the  references  to  the  tapes  are  removed  from  the  database;  the 
tapes  are  not  imcataloged  since  the  merged  database  does  not  actually  own  them. 

Optical  Disk  Additional  consideration  must  be  given  when  merging  databases  containing 

Considerations  SYSOUT  archived  to  secondary  (optical)  disk  storage.  For  more  information, 

Chapter  10,  "Using  the  Optical  Disk  Interface." 


Generation  Numbers  The  resulting  generation  numbers  in  the  output  merged  database  are  computed 

from  the  archival  dates  of  the  SYSOUT  groups.  The  numbers  are  based  upon  a 
24-hour  generation  beginning  at  the  time  of  day  specified  in  the  TIME 
initialization  parameter  in  the  last  database  to  be  merged.  The  current  generation 
number  in  the  output  merged  database  is  one  more  than  that  of  the  most  recently 
archived  SYSOUT  group. 


NAME 

The  NAME  control  statement  is  used  to  specify  the  high-level  name  of  the 
CA-View  database.  If  omitted,  the  high-level  name  specified  as  the  FARM 
parameter  on  the  EXEC  JCL  statement  is  used.  The  NAME  control  statement 
applies  to  all  control  statements  following  it  until  another  NAME  control 
statement  is  enco vmtered  or  changed  by  &e  RENAME  control  statement. 

Syntax  name  high-level-name 


where  high-level-name  specifies  the  high-level  name  for  the  CA-View  database. 
high-level-name  is  comprised  of  one  or  more  qualifiers  separated  by  periods.  The 
maximum  length  of  the  name  is  17  characters.  This  operand  is  required. 


OLOAD 


The  OLOAD  control  statement  is  used  to  load  the  panel,  message,  and  skeleton 
JCL  members  in  the  online  library  to  the  database.  The  online  library  is  defined 
with  DD  statement  SAROLIB. 


The  high-level  name  of  the  database  must  have  previously  been  defined  with  the 
NAME  control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 


Syntax 


OLOAD 
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RENAME 


Syntax 


REORG 


The  RENAME  control  statement  renames  a  database.  The  RENAME  control 
statement  renames  all  data  sets  for  the  database  as  well  as  the  lock  data  set  if  it 
exists. 


The  high-level  name  of  the  database  to  be  renamed  must  have  previously  been 
defined  with  the  NAME  control  statement  (or  the  FARM  parameter  of  the  EXEC 
JGL  statement). 

SEHAUE  new-name 

where  new-name  specifies  the  high-level  name  to  which  the  database  is  renamed. 
The  maximum  length  of  the  name  is  17  characters.  This  operand  is  required. 

After  completion  of  the  rename  operation,  the  high-level  name  of  the  database 
that  is  used  by  subsequent  operations  is  set  to  the  new  name  of  the  database.  For 
example,  the  following  statement: 

REKAHE  VIEW.NEWSYSl 

is  identical  to  the  following  two  statements: 

RENAME  VlEW.NEWSYSl 
NAME  VIEW.HEWSYSl 


The  REORG  control  statement  performs  maintenance  functions  on  the  database; 
it  can  be  run  in  asynchronous  or  non-asynchronous  mode. 

A  REORG  of  a  database  does  the  following: 

■  Defragments  the  index 

■  Builds  a  queue  of  empty,  reusable  index  blocks 

■  Incorporates  the  empty  blocks  from  the  queue  again 

■  Rebuilds  the  alternate  index  (used  for  online  selection  by  DATE) 

The  high-level  name  of  the  database  to  be  reorganized  must  have  been  defined 
with  the  NAME  control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL 
statement). 
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Syntax 


Syntax 


SE0R6  option 

where  option  specifies  one  of  the  following: 

RESERVE  A  stand-alone  reorganization  of  the  index  filers  to  be  performed 
with  the  database  reserved  for  the  duration  of  the  reorganization 
This  is  the  default. 

NORESERVE  A  stand  alone  reorganization  of  the  index  file  is  to  be  performed 
without  placing  a  reserve  on  database 

Specify  NORESERVE  only  if  you  can  be  certain  that  no  one  else 
could  be  updating  the  database  while  the  REORG  operation  is 
proceeding. 

ASYNCH  An  asynchronous  reorganization  of  the  index  file  is  to  be 
performed 

The  database  can  be  actively  used  by  others  during  the 
reorganization;  however,  the  less  database  activity  there  is,  the 
faster  the  REORG  will  run. 

The  standard  and  asynchronous  REORG  can  be  prematurely  terminated  with  a 
stop  MVS  operator  command. 

F  jobnama,  STOP 

or 

F  jobname, STOP 

The  job  name  on  the  stop  command  references  the  MVS  job  name  executing  the 
SARDBASE  utility. 

When  the  standard  REORG  is  stopped,  the  full  reorganization  process  is  aborted, 
and  the  database  is  reset  to  the  pre-reorganization  state.  The  asynchronous 
REORG,  however,  will  be  stopped  in  a  manner  that  will  leave  the  previous 
reorganization  activity  intact. 

The  SARDBASE  REORG  facihty  also  supports  a  status  command  via  the  modify 
MVS  operator  command: 

F  joJbuame,  STATUS 

The  status  command  issues  messages  to  the  operator  console,  describing  the  state 
and  location  of  reorganization  process. 
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RESTORE 


Syntax 


The  RESTORE  control  statement  is  used  to  recover  a  database  that  has  been 
destroyed  (for  example,  from  a  media  failure  of  the  disk  containing  one  of  the 
database  data  sets); 

The  SAKDBASE  program  performs  the  following  for  a  restore  operation: 

■  Copies  the  backup  of  the  master  index  from  tape  to  the  database 

■  Loads  whatever  SYSGUT  it  can  to  the  new  database  from  the  old  database 

The  SYSOUT  groups  in  the  old  database  are  located  based  on  the  information  in 
the  backup  of  the  master  index  and  not  on  the  actual  master  index  in  the  old 
database  since  the  master  index  in  the  old  database  is  probably  destroyed.  It  is 
imperative  that  the  old  database  (as  it  was  defined  at  the  time  of  the  backup)  be 
used,  and  not  a  copy  of  the  old  database.  The  SYSOUT  groups  in  a  copy  of  the 
old  database  would  be  rearranged  and  would  not  match  the  location  information 
in  the  backup  of  the  master  index. 

The  database  into  which  the  restore  is  done  must  be  a  newly  created  empty 
database  and  its  high-level  name  must  have  been  defined  with  the  NAME  control 
statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 

To  use  the  restore  operation,  a  tape  backup  of  the  master  index  must  exist. 
RESTORE  rebuilds  the  index  from  the  tape  backup  copy.  Either  the  SARREGV  or 
SARTAPE  DD  statement  must  be  included  in  the  JCL  for  the  RESTORE  job.  In 
general,  a  site  that  is  concerned  with  recovery  is  already  doing  regular  database 
backups.  In  such  an  environment,  the  SARRECV  DD  statement  is  included  and 
the  SARTAPE  DD  statement  is  excluded,  allowing  SARDBASE  to  use  the 
information  in  the  recovery  data  set  to  dynamically  allocate  the  correct  backup 
tape. 

RESTORE  old-name  relative -backup 


where: 

old-name  Specifies  the  high-level  name  of  the  old  database  that  is  being 

restored 

If  the  old  database  has  been  completely  lost,  this  operand  must 
be  omitted;  if  it  is  omitted,  oirly  the  database  index  is  restored. 
The  operand  must  be  specified  in  order  to  specify  a  relative 
backup. 
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Warning!  the  old  databj«!e  it  in\  ot  it  ^till  exist-,  so  tha  S  \1<I  )B  VbF 

RLslOKl  ccincopi  whatuxer  b\bC)U1  data  it  len  ai-t-tss  ti  thoiii.'\ 
database  i^ou  i  an  alternate  el\  usethi  b  \RRSr  iitilitx  to  load  ^^bOTT^  data 
trom  '■‘ac.kup  tapes  or  nn  UNT  (^AD  tape  •  I  nlcss  torv  aid  let-OM-rx  dal  i  -els 
xs  ore  in  use,  all  S(  >1.  I  data  archix  ed  sinee  the  last  backup  i  oi  I  \l  I  ^  M") i  - 

relative-backup  Specifies  the  signed  relative  number  of  the  backup  to  be  used 

The  most  recent  backup  is  specified  as  -t-Odr  -0.  The  previous 
backup  is  specified  as  -1.  If  relative-backup  is  omitted,  -i-O  is 
assumed.  The  value  is  ignored  xvhen  the  JGL  contains  a  DID 
statement  for  SARTAPE.  Folloxving  a  database  RESTORE 
operation  the  online  panels,  messages,  and  skeleton  JGL  must  be 
reloaded  using  OLOAD. 


SET 

The  SET  control  statement  is  used  to  initialize  the  database  for  online  viewing  of 
database  statistics. 

For  information  about  online  database  status  viewing,  see  the  CA-View  Online 
User's  Guide. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JGL  statement). 

Syntax  set  option 

where  option  specifies  STATS  to  initialize  the  database  statistics  so  they  may  be 
viewed  online,  via  the  Database  Status  panel. 


Warningl  When  usmg  the  SET  control  statement,  the  CA-View  archival 
-lifted  1  i-k should  be  mictixe 


STATUS 

The  STATUS  control  statement  is  used  to  display  usage  statistics  about  the 
CA-View  database.  These  usage  statistics  are  as  follows: 

■  Totalblocks 

■  Total  blocks  used 

■  Percentage  of  utilization 
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■  Lock  data  set  status  (if  one  exists) 

■  Cylinders,  blocks,  used  blocks,  and  error  blocks  for  each  data  set  in  the 
database 

■  Nromber  of  empty  blocks  (without  data)  in  the  database  index 


Syntax 


You  can  view  a  partial  set  of  these  statistics.  For  more  information,  see  the 
chapter,  "System  Administration"  in  the  CA-View  Online  User's  Guide. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 

STATUS  display-option  reserve-option 
where: 

display-option  Specifies  FULL  to  print  complete  statistics  for  the  database, 

master  index,  and  data  sets,  or  INDEX  to  print  statistics  for  the 
database  and  master  index  only 

If  the  parameter  is  omitted,  statistics  for  the  database  and  data 
sets  are  printed, 

reserve-option  Specifies  either  RESERVE  to  place  a  reserve  on  the  database  for 

the  duration  of  the  index  evaluation  process  or  NORESERVE  to 
not  place  a  reserve  on  the  database 

This  option  is  only  applicable  when  specified  with  the  display- 
option.  Because  the  master  index  is  updated  by  many  tasks,  jobs, 
or  online  sessions,  the  master  index  data  can  change  during  the 
evaluation  process,  causing  inconsistent  statistics.  The  RESERVE 
option  delays  external  updates  to  the  database  for  the  pxupose 
of  obt^ing  consistent  statistics .  If  reserve-option  is  omitted, 
NORESERVE  is  asstuned. 

To  compile  index  statistics  information,  the  entire  master  index  must  be  read: 
Depending  on  the  size  of  tiie  database,  this  process  can  take  a  considerable 
amoxmt  of  time. 
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Messages  Resulting  The  STATUS  statement  causes  the  SARDBA09  messages  to  be  displayed.  The 

From  STATUS  meaning  of  the  index  statistics  displayed  in  the  SARDBA09  messages  are  as 

follows: 


SARDBA09 

Message 

Description 

Index  levels 

Specifies  the  number  of  levels  or  hierarchies  in  the  master 
index 

Index  records 

Specifies  the  total  number  of  records  in  the  master  index 

Index  allocations 

Specifies  the  total  number  of  control  areas  or  segments  that 
comprise  the  master  index 

Index  blocks 

Specifies  the  total  number  of  database  blocks  that  comprise 
the  master  index 

These  index  blocks  can  be  pointer  blocks,  data  blocks,  or 
free  blocks. 

Index  used  blocks 

Specifies  the  total  number  of  database  blocks  currently 
being  used  in  the  master  index 

This  value  includes  the  index  pointer  block,  the  index  data 

blocks,  and  the  index  empty  blbcks. 

Index  pointer  blocks 

Specifies  the  total  number  of  higher  level  hierarchical 
index  blocks  that  reference  lower  level  index  blocks 

Index  data  blocks 

Specifies  the  total  number  of  database  blocks  that  comprise 
the  lowest  level  of  the  master  index,  and  that  contain  &e 
physical  index  data 

Index  empty  blocks 

Specifies  the  total  number  of  index  data  blocks  that  do  not 
contain  any  index  records 

When  index  records  are  deleted  from  the  master  index,  the 
index  data  is  removed  from  the  index  data  block.  When  all 
index  records  have  been  removed  from  the  index  data 
block,  the  index  data  block  is  considered  empty  but 
available  for  subsequent  use  in  the  same  key  range. 

REORG  or  UNLOAD/LOAD  functiojis  of  the  SARDBASE 
utility  are  recommended  for  a  database  with  a  high 
percentage  of  empty  blocks. 
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UNLOAD 


Syntax 


UNLOCK 


Syntax 


The  UNLOAD  control  statement  is  used  to  unlbad  the  CA-View  database  to  a 
sequential  output  file  for  backup  purposes.  The  records  in  the  database  are 
written  in  ascending  key  sequence  order  to  the  SARUNLD  data  set  as  variable- 
length  blocked  records. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  FARM  in  the  EXEC  JCL  statement). 

UNLOAS  [SECOND I NOSECOND] 

The  SECOND/NOSECOND  parameter  is  for  use  when  you  have  archival  data  in 
secondary  (optical  disk)  storage  and  are  planning  to  use  the  MERGE  function.  Do 
not  use  these  parameters  if  you  are  going  to  use  the  LOAD  function.  The  LOAD 
function  copies  the  index  itiiormation  about  the  SYSOUT  groups  on  secondary 
disk  storage — that  is,  LOAD  transfers  ownership  of  the  secondary  disk  storage 
data  that  is  already  archived,  while  MERGE  actually  reloads  the  data  to  another 
optical  disk  data  set. 

The  SECOND/NOSECOND  parameter  has  a  default  value  of  NOSECOND. 
Specif5dng  SECOND  can  substantially  increase  the  time  required  to  perform  the 
UNLOAD  function. 


The  UNLOCK  control  statement  unlocks  or  releases  a  lock  held  by  a  user  or  job 
on  the  lock  data  set. 


The  lock  data  set  cannotbe  released  if  a  CA-View  user,  CA-Yiew  archival  task,  or 
CA-View  utility  holds  a  lock  or  reserve  on  the  lock  data  set  while  updating  the 
CA-View  data  set  and  the  user,  archival  task,  or  utility  is  canceled  or  abends,  or  a 
system  crash  occurs.  Subsequently,  all  output  operations  to  the  CA-View 
database  will  wait.  The  STATUS  control  statement  can  be  used  to  interrogate  the 
status  of  the  lock  data  set,  and  optionally,  the  UNLOCK  control  statement  can  be 
used  to  release  that  lock. 

The  high-level  name  of  the  database  must  have  been  defined  with  NAME  control 
statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 

UNLOCK 


Warning!  It  a  k\k  is  released  Inmi  a  valid  C  \-Vioi%  usi-i  Ihi  t  \-\  lew 
ar  hi  til  ttisk  iitiliU  j  user^l"^n  nKnd  i'Ci,uis  In  .iJdiliO'i  tJii- 

I  umlition  could  comipt  of  th«.  CA-\  icv%  ddtjb.i'-L 
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VERIFY 


Syntax 


VERSION 


Syntax 


The  VERIFY  control  statement  is  used  to  logically  verify  the  structure  and 
allocation  of  the  data  in  the  CA^View  database  and  to  correct  any  problems  found 
in  the  process. 

The  high-level  name  of  the  database  must  have  been  defined  with  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement). 

VERIFY 

Note:  The  VERIFY  process  may  not  be  able  to  recover  aU  records  in  the  database. 
Inconsistencies  can  appear  in  the  records  created  and  used  by  the  DEFine  SYS 
and  DEFine  DIST  functions.  These  inconsistencies  can  only  be  corrected  by 
redefining  the  missing  component. 


Warning!  V.  l>on  using  the  SLT 1  ontnJ  bldiemtnt,  Fl  '•ure  tlut  tlii- 1 
<iii.hu  cil  ".tarted  task  is  marlive 


The  VERSION  control  statement  is  used  to  set  the  database  version. 

The  high-level-name  of  the  database  must  have  been  defined  wifii  the  NAME 
control  statement  (or  the  FARM  parameter  of  the  EXEC  JCL  statement).  Also,  the 
database  must  have  been  created  via  the  ADDDS  control  statement. 

VERSZON  releAsenvmber 

where  releasenumber  specifies  the  number  of  the  CA-View  release  to  which  the 
database  is  to  be  set.  If  not  specified)  this  parameter  defaults  to  the  current 
release. 

Valid  values  are  5.0, 6.0, 6.1, 6.5,  h6,  and  1.7,  and  2.0. 


If  you  need  to  set  the  version  of  a  CA-View  2.0  database  back  to  CA-View  1.7, 
STEFLIB  to  the  2.01oad  library  for  the  SARDBASE  job.  Then  use  the  1.7  load  . 
library  for  the  SARSTC  started  task  and  online  access. 


After  running  SARDBASE  VEI^ION,  SARINTT  should  be  run  to  set  the 
initialization  parameters. 
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SARDBASE  Examples 

The  following  examples  demonstrate  the  facilities  available  with  SARDBASE 
database  maintenance. 


Example  1;  Creating  a  Database 


In  this  example,  a  new  database  is  created  with  a  high-level  name  of 
VIEW.SYSTEMl;  it  is  allocated  50  cylinders  on  3380  volume  SAROOl. 

//EXAHFLEl  JOB  ACCOONT, PSOGRAUHER 
//STEPl  EXEG  P6H=SARDBASE 
//STEPLZB  DD  DSN=CAZ .GAZLXB, DISP=SHR 
//SYSPRIHT  DD  SYSOUT=* 

//SYSIN  DD  * 

NAME  VIEW.SYSTEMl 

ADDDS  UNIT=3380  VOIii=SAR001  CYI.=50 
/* 


Example  2:  Adding  Space 


In  this  example,  the  database  defined  in  the  previous  example  is  out  of  space  and 
an  additional  100  cylinders  is  added  to  the  database  on  3380  volume  SAR002. 
Statistics  on  the  database  after  the  addition  of  the  space  are  displayed. 


//EXAMPLE2  JOB  AGCOUNT, PROGRAMMER 
//STEPl  EXEC  PGM=SARDBASE 


//STEFLXB  DD  DSN=CAX.CAXDXB,DXSPsSHR 
//SYSPRXNT  DD  SYSOUT=* 

//SYSXN  DD  * 

NAME  VIEW.SYSTEMl 


ADDDS  UNXT=3380  VOL=SAR002  GYL=100 


STATUS 

/* 


Example  3:  Changing  Online  Members 


In  this  example,  when  changes  are  made  to  the  online  library,  the  library  is 
reloaded  to  database  VIEW.SYSTEM1. 

//EXAMPLES  JOB  ACCOUNT, PROGRAMMER 

//STEPl  EXEC  PGM=SARDBASE,PARM=' VIEW.SYSTEMl' 

//STEPLIB  DD  DSN=CAI.CAILIB,DISP=SHR 
//SARGLIB  DD  DSN=VIEW.GLIB, DISP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

OLOAD 

/* 
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Example  4:  Copying  a  Database 


In  this  example,  database  VIEW.SYSTEMl  continually  grows  in  size  with  the 
addition  of  many  data  sets.  For  performance  reasOTis,  it  is  copied  to  a  new  large 
database.  The  old  database  is  to  be  kept  imder  the  name  of  VIEW.OLDSYSl. 

/7EXAMPLE4  JOB  ACCOUNT, PROGRAMHER 
//STEP!  EXEC  P6H=SARnBASE 
//STEPLIB  DD  DSN=CAI.eAlLIB,DISP=SHR 
//SXSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

NAME  VIEW.SYSTEMl 
RENAME  VIEW.OLDSYSl 
NAME  VIEW.SYSTEMl 

ADDDS  UN1T=3380  VOL=SAR001  CYL=600 
COPY  VIEW.OLDSYSl 
/* 


Example  5:  Deleting  a  Database 


In  this  example,  database  VIEW.OLDSYSl  is  no  longer  being  used  and  is  deleted. 

//EXAMPLES  JOB  ACCOUNT, PROGRAMMER 
//STEPl  EXEC  PGM=SARDBASE 
/ /STEPLIB  DD  DSN=CAI . CAILIB, DISP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

NAME  VIEW.OLDSYSl 

DELETE 

I* 


Example  6:  Sequential  Copy  of  the  Index 


In  this  example,  a  sequential  copy  of  the  master  index  for  database 
VIEW.SYSTEMl  is  written  out. 

//EXAMPLES  JOB  ACCOUNT, PROGRAMMER 
//STEPl  EXEC  PGM=SARDBASE 
//STEPLIB  DD  DSN=CAI. CAILIB, DISP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SARIOUT  DD  DSN=USBR.DATA  SET, DISP= { , CATLG), 

//  DNIT=SYSnA,SPAGE=(CYL,  (1,1)}) 

//SYSIN  DD  * 

NAME  VIEW.SYSTEMl 
IDXOUT 
/* 
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Example  7:  Restore 


In  this  example,  the  CA-View  database  is  restored  from  the  most  recent  backup, 
as  indicated  in  the  recovery  data  set  maintained  by  SAKSTC.  The  old  database  is 
named  VIEW.SYSTEMl  and  a  new  database  named  VIEW.NEWSYS1  is  created. 
The  following  job  recovers  the  database: 


//RESTORE 

//STEP! 

//STEPLIB 

//SYSPRINT 


JOB  ACGOtmr,  PROGRAUHER 
EXEC  P6H=SARDBASE 
DD  DSI1=GAI.GAXLXB,DTSP=SHR 
DD  SYSOUT=* 


//SARRECV  DD  DSN=VZEH.SARRECV,DISP=SHR 
//SYSIN  DD  * 

NAME  VZEW.EEWSYSl 

ADDDS  UNZT=3380  VOD=SAR001  CYL=600 
RESTORE  VZEW.SYSTEMl 


/* 


Example  8a:  Tape  Map/Restore  (Tape  Map) 


In  this  example,  the  CA-View  database  is  recovered  from  the  most  recent  backup 
and  the  recovery  data  set  is  not  available.  The  old  database  is  named 
VIEW.SYSTEMl  and  a  new  database  named  VIEW.NEWSYSl  is  created.  When 
the  recovery  data  set  is  not  available  to  identify  the  most  recent  backup,  SARTCP 
must  be  run  to  map  the  current  archival  tape  to  locate  the  position  of  ^e  master 
index  backup. 


The  following  job  maps  the  archival  tape: 


//TAPEHAF 

JOB 

ACCOUNT, PROGRAHUER 

//STEPl 

EXEC  P^=SARTCP 

//STEPliZB 

DD 

DSN=CAZ .CAZLZB, DZSP=SHR 

//SYSPRZNT 

DD 

SYSOUT=* 

//TAPEZN 

DD 

DSN=VZEW . SYSTEHl . SARTAPE .T0000Z56, 

// 

DZSP=OI)D 

//SYSZN 

DD 

DUMMY 

To  view  a  sample  report,  see  the  section  SARTCP:  Tape  Recovery  Example  later 
in  this  chapter. 


Example  8b:  Tape  Map/Restore  (Restore) 

Assume  the  map  of  the  archival  tape  shows  master  index  backups  in  positions  50 
and  1370  of  the  tape.  This  means  position  1370  contains  the  most  recent  backup. 
To  restore  the  most  recent  backup,  you  could  use  the  following  JCL. 

Note:  This  example  does  not  support  a  master  index  that  spans  two  reels.  If  you 
have  a  master  index  that  spans  two  reels,  a  RESTORE  with  SARRECV  DD 
statement  is  the  recommended  method. 
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The  following  job  is  executed  to  restore  the  database: 

//RESTORE  JOB  ACCOUNT, PROGRAMMER 
//STEPl  EXEC  P6M=SARDBASE 
//STEPLXB  DD  DSN=CAX.CAXI.ZB,DXSP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SARTAPE  DD  DSN=VIEW.SYSTEM1.SARTAPE.T0000156, 
//  DXSP=OLD,rABEL=1370 

//SYSIN  DD  * 

NAME  VXEW.NEWSYSl 

ADDDS  UHXT=3380  VOL=SAR001  CYL=600 
RESTORE  VZEW.SYSTEHl 
/* 


Example  9:  Sequential  Copy  of  the  Entire  Database 


In  this  example,  the  CA-View  database  is  unloaded  for  backup  purposes.  The 
unloaded  backup  is  a  sequential  data  set  on  tape. 


The  following  job  vmloads  the  database: 

/ /UMDOAD  JOB  ACCOUNT , PROGRAMMER 

//STEPl  EXEC  PGM=SARDBASB 

//STEPLZB  DD  DSN=CAI.CAILXB,DISP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SARUNLD  DD  DSN=VIEW,. UNLOAD,  DISP=NEW, 
//  UNIT=TAPE,DCB=(RECFM=VB, 

//  LRBCL«32756,BLKS1ZE=32760 ) 

//SYSIN  DD  * 

NAME  VXEW.SYSTEHl 
UNLOAD 
/* 


Example  1 0:  Recover  Unloaded  Backup 


In  this  example,  the  CA-View  database  is  recovered  from  a  previous,  unloaded 
backup  (see  the  previous  example).  Statistics  on  the  database  following  the  load 
are  displayed. 


The  following  job  reloads  the  database: 


//LOAD 

//STEPl 

//STEPLIB 

//SYSPRINT 

//SARLOAD 

// 

// 

//SYSIN 

LOAD 

STATUS 

/* 


JOB  ACCOUNT, PROGRAMMER 
EXEC  PGM=SARlffiASE,PARH='VXEW.SYSTEMl' 
DD  DSN=CAX.CAXLXB, DISPOSER 
DD  SYSOUT=* 

DD  DSN=VXEW,. UNLOAD,  DISP=OLD* 
UNIT=TAPE, DCB= (RECPM=VB, 

LRECL=3  2 75 6 , BLKSXZE=3  2760) 

DD  * 
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Recovery  File  Utility  Program:  SARRCOV 

The  Recovery  File  Utility  program  (SARRGOV)  creates  a  recovery  file  with  data 
such  as  tape  volume  serial  ruunber,  data  set  name,  DSN  number,  DSN  count,  and 
file  sequence  number.  This  program  also  allows  limited  editing  of  the  recovery 
file  and  prints  a  formatted  listing  of  it. 

This  utility  program  can  be  helpful  when: 

■  No  recovery  file  has  been  created  but  one  is  needed 

■  An  existing  recovery  file  has  been  damaged  and  must  be  recreated 


Job  Control  Statements 

The  following  job  control  statements  are  required  to  execute  SARRCOV: 


Control  Statement  Description 

JOB 

Iniaates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARRCOV) 
and  optionally,  the  high-level  name  of  the 

CA-View  database  as  the  PARM  parameter 
(PARM='VIEW.SYSTEM1') 

STEPLIBDD 

Defines  the  load  library  containing  SARRCOV 

If  the  program  resides  in  a  link  list  library,  omit 
this  statement: 

SYSUDUMP  DD 

Defines  the  output  data  set  (normally  SYSOUT) 
used  for  listing  the  system  memory  contents  at  the 
time  of  an  abend 

SARRECV  DD 

Defines  a  user-maintained  sequential  data  set  used 
as  the  recovery  file 

SYSINDD 

Defines  a  card  image  data  set  containing  the 
control  statements  to  be  input 
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SARRCOV  Control  Statements 


Two  control  statements,  FILESEQ  and  DATA  SET  NAME/VOLSER  are  used 
with  the  Recovery  File  Utility  program.  They  are  covered  in  detail  on  the 
following  pages. 


FILESEQ 


The  FIEESEQ  control  statement  specifies  the  file  sequence  of  the  master  index  on 
the  backup  tape.  To  determine  the  file  sequence  number  of  the  master  index 
backup,  use  the  mapping  feature  of  the  SARTCP  program.  If  the  backup  tape  is 
mapped  with  b5rpass  label  processing  (LABEL=(,BLP)),  do  not  include  the  file 
containing  the  standard  labels  in  the  counting  for  the  FILESEQ  parameter. 


Syntax 


FILESEQ=unmui 


where  nnnn  specifies  the  file  sequence  of  the  master  index  on  the  backup  tape. 
This  value  cannot  exceed  32767. 

For  an  example  using  FILESEQ^  see  SARRCOV  Initialization  on  the  following 
pages. 


DATA  SET  NAME/VOLSER 

The  DATA  SET  NAME/VOLSER  control  statement  specifies  the  data  set  name 
and  the  VOLSER  of  the  backup  tapes. 

Syntax  data-set -name ^volser 

where; 

data-set-name  Specifies  the  data  set  name  of  the  backup  tape 
volser  Specifies  the  VOLSER  of  the  backup  tape 

The  data  set  must  reside  on  a  direct  access  volume.  Since  the  data  set  is  used  to 
recover  the  CA-View  database,  it  should  not  be  placed  on  the  same  volumes 
contaming  data  sets  for  the  GA-View  database.  The  data  set  must  not  be  allocated 
with  DCB  attributes.  Only  one  track  can  be  allocated  for  this  data  set. 


Recovery  Data  Set 
Guidelines 
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SARRCOV  Initialization 


SARRCOV  Example  1 


The  following  JGL  will  update  a  recovery  file  and  indicate  that  the  most  current 
backup  of  the  master  index  is  on  file  99  of  tape  data  set 
VIEW.SYSTEM1.SARTAPE.T0000009  and  continues  onto  the  following  two 
backup  tapes. 


//EXaHFLEl  JOB  ACGOONT,  PROGR2\llMER 
//STEPl  EXEC  PG»=SARRCOV 


//STEPLIB  DD  DSN=CAI.CA1LIB,D1SP=SHR 
//REPORT  DD  SYSOUT=* 

//SYSUDUMP  DD  SYSOUT=* 

/  /  SARRECV  DSN=V1EM .  SARRECV,  DISP=OLD 
//SYSIN  DD  * 

FZLESEQ=99 

VIEW .  SYSTEHl .  SARTAPE  .  TO  0  0  0 0 0 9  ,  0  0 1 0 0 
VIEW . SYSTEM! . SARTAPE .T0000010>00101 
VIEW . SYSTEM! . SARTAPE .T00000!!,00!02 
// 


SARRCOV  Example  2  The  following  JCL  initializes  a  recovery  file,  and  Hsts  an  existing  recovery  file. 


//EXAMPLE! 

//STEP! 

//STEPLIB 

//REPORT 

//SYSUDOMP 

//SARRECV 

//SYSIN 

// 


JOB  ACCOUNT, PROGRAMMER 
EXEC  PGM=SARRCOV 
DD  DSN=CAI.CA1LIB,DISP=SHR 
DD  SYSOUTs* 

DD  SYSO0T=* 

DD  DSNsVlEW . SARRECV, D1SP=0LD 
DD  DUMMY 


Note:  This  process  does  not  initialize  the  recovery  data  set.  If  the  SYSIN  data  set 
is  empty  (as  in  this  case)  SARRCOV  will  only  list  the  entries  in  the  existing 
recovery  data  set.  CA-View  Database  Restore  (SARRSP). 

Use  the  SARRSP  utility  program  to  restore  to  the  database  all  panels,  messages, 
and/ or  SYSOUT  groups  that  reside  in  disk  status  from  either  SARDBASE 
UNLOAD  tapes  or  CA-View  backup  tapes.  This  utility  must  be  executed  after  the 
normal  restore  process  provided  with  the  SARDBASE  utility  (RESTORE  control 
statement). 


In  certain  situation,  the  restore  function  provided  with  the  SARDBASE  utility 
cannot  fully  restore  the  contents  of  the  CA-View  database. 
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The  SARDBASE  restoration  process  attempts  to  copy  panels,  messages,  and 
SYSOUT  groups  from  the  old  database,  if  specified,  to  repopulate  the  database. 
When  the  old  database  is  seriously  damaged  or  does  not  exist,  panels,  messages, 
and  SYSOUT  groups  that  are  unsuccessfully  copied  occupy  an  empty  file.  In  this 
case,  the  SARTDR  utility  (tape  dump  restore  utility)  is  normally  used  to  reload 
entire  tapes  or  generations  back  to  the  database.  However,  with  the  expanded 
retention  options  capability  of  maintaining  SYSOUT  on  disk  for  long  periods  of 
time,  this  process  requires  a  vast  amount  of  disk  space  for  the  database  to  hold 
SYSOUT  that  didn't  previously  reside  on  disk. 

The  SARRSP  utility  attempts  to  restore  any  panel  data,  message  data,  or  non* 
resident  SYSOUT  group  from  a  CA-View  unload  tape  (if  the  SARLOAD  DD 
statement  is  specified)  or  dynamically  from  the  CA*View  backup  tape.  The 
CA.-View  backup  tapes  are  dynamically  allocated,  if  needed,  by  tape  sequence 
number.  In  cases  where  the  backup  tape  is  damaged  or  tmusable,  the  respective 
SYSOUT  groups  are  removed  from  disk  status. 

Note:  It  may  be  necessary  to  reload  the  online  library  (panels  and  messages)  to 
the  database  with  the  SARDBASE  utility  (OLOAD  control  statement)  after  the 
restore  process  if  all  panel  and  message  data  is  not  completely  restored. 


Job  Control  Statements 

The  following  job  control  statements  are  required  to  execute  SARRSP: 


Control  Statement 

Description 

JOB 

Initiates  the  job 

EXEG 

Specifies  the  program  name  (PGM=SARRSP)  and  the  high- 
level  name  of  the  CA-View  database  as  the  PARM 
parameter  (PARM='VIEW.SYSTEM1') 

STEPLIBDD 

Defines  the  load  library  containing  SARRSP 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement 

SYSPRINTDD 

Defines  a  sequential  output  data  set  (normally  SYSOUT) 
used  for  messages 

If  not  a  SYSOUT  data  set,  data  set  must  be  coded  with 
RECFM=FBA,  LRECL=121,  and  BLKSIZE=1210. 

Continued 
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Example 


Continued 

Control  Statement 

Description 

SARLOADDDj 

Defines  an  GA^View  unload  tape  created  by  the 

SARDBASE  utility  (UNLOAD  control  statement)  from 
which  panels,  messages,  and  SYSOUT  groups  can  be 
restored 

FREE=CLOSE  can  be  coded  on  the  DD  statement  to 
dismoimt  the  tape  at  the  end  of  the  SORT  input  phase  as 
opposed  to  step  terminationi  This  DD  statement  is  optional 
and  should  only  be  specified  when  a  CA-Yiew  unload  tape 
exists. 

SORTLIBDD 

Defines  the  load  library  that  contains  the  SORT  program 
IflDrary 

This  DD  statement  may  not  be  needed  if  the  sort  program 
library  is  moved  to  LPA. 

SYSOUT  DD 

Defines  a  sequential  output  data  set  (normally  SYSOUT)  to 
which  SORT  messages  are  written 

SORTWKnn  DD 

Defines  temporary  sort  work  disk  space  where  nn 
represents  a  numeric  number 

Normally  a  minimum  of  three  sort  work  DD  statements 
are  specified. 

To  restore  panels,  messages,  and  SYSOUT  to  the  VIEW.SYSTEMl  database,  the 
following  JCL  is  used: 


//SAKRSF 

//STEPl 

//STEPIiIB 

//SARLOAD 

// 

//SYSPRINT 

//SYSODDMP 

//SYSOUT 

//SORTLIB 

//SORTWKOl 

// 

//SORTWK02 

// 

//SORTWK03 

// 


JOB  ACCOUNT, PROGRAHHER 
EXEC  PGM=SARRSP , PARM= ' VIEW , SYSTEMl ' 
DD  DSN=CAI.CAZLXB,DZSP=SHR 
DD  DSN=VZEW . SYSTEMl , ONLOAD ( 0 ) , 
DZSP=SHR, FREE^CLOSE 
DD  SYSOUT=* 

DD  SYSODT=* 

DD  SYSODT=* 

DD  DSN=SYSl.SORTLZB,DZSP=SHR 
DD  XniZT=SYSDA, 

SPACES (CYL, (10) , ,CONTZG) 

DD  UNXT=SYSDA, 

SPACES (CYL, ( 10 ) , , CONTZG) 

DD  tJNZTsSYSDA, 

SPACES (CYL, ( 10 ) , , CONTZG) 
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Tape  Copy  Utility  (SARTCP) 

The  tape  copy  utility  SARTCP  can  be  used  to  map,  copy,  or  salvage  SYSOUT  on 
an  archival  tape. 


Control  Statements 

Two  control  statements  are  provided  to  skip  over  damaged  files.  They  are  NULL 
and  SKIP.  The  NULL  statement  inserts  a  nuU  SYSOUT  group  to  restore  correct 
positioning  after  a  SKIPped  group. 


Related  Utilities 


If  you  use  3480/3490  processing  (via  the  TAPEOPT  initialization  parameter)  and 
you  use  SARTCP  on  a  backup  tape,  then  you  should  also  run  SARTDR  TADU  on 
the  tape.  SARTDR  TADD  adds/updates  the  disk  database  group  control  records 
(GCRs).The  new  GCRs  will  have  tt\e  updated  3480/3490  block  ID  information.  If 
you  do  not  run  SARTDR  TADD,  the  reports  will  be  accessed  without  the  benefit 
of  3480  block  ID  processing. 

If  you  have  the  expanded  access  server,  then  you  must  also  run  SARPAC  on  the 
tape  to  make  it  available  to  the  server. 


Recovering  a  Tape:  No  Duplex  Available 

The  following  steps  describe  the  actions  you  need  to  take  to  recover  a  tape  when 
no  duplex  is  available. 

i;  Map  the  contents  of  the  backup  tape  by  using  the  SARTCP  program. 

You  may  have  to  use  bypass  label  processing  (BLP)  in  the  JCL  to  have 
SARTCP  start  at  a  point  in  the  tape  that  is  read-able. 

2.  Run  SARTCP  to  copy  the  backup  tape  to  a  new  tape. 

You  must  use  the  SKIP  control  cards  in  order  to  bypass  the  unreadable 
portions  of  the  input  tape. 

Each  SKIP  statement  should  have  a  corresponding  NULL  statement  to 
maintain  proper  positioning  on  the  output  tape. 

3.  Uncatalog  the  old  (damaged)  backup  tape,  then  catalog  the  new  backup  tape. 
You  can  do  this  in  Step  2,  in  the  JCL. 
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Recovering  a  Tape:  Duplex  Tape  Available 

The  following  steps  describe  the  actions  you  need  to  take  to  recover  a  tape  when 
a  duplex  tape  is  available. 

1.  Uncatalog  the  damaged  backup  tape,  but  set  it  aside,  in  case  the  duplex  tape 
cannot  be  located  or  is  damaged. 

2.  Use  SARTCP  to  copy  the  duplex  tape  to  a  new  tape  with  the  same  data  set 
name  as  the  original  backup  tape. 

Note:  The  new  tape  must  be  large  enough  to  contain  the  full  contents  of  the 
duplex  tape. 

3.  Catalog  the  new  backup  tape. 

You  can  do  this  in  Step  2,  in  the  JCL. 

Tape  Map  Reports 


SARTCP  produces  a  report  listing  of  the  SYSOUT  groups  and  master  index 
backups  that  are  on  the  archival  tape.  The  following  is  a  list  of  the  contents  of  the 
archival  tape: 


Field 

Contents 

Input  position 

The  position  of  the  entry  on  the  input  tape 

Output  position 

The  position  the  entry  has  on  the  output  tape  (if  created, 
with  the  TAPEOUT  DD  statement) 

Recorded  position 

The  position  as  indicated  in  the  GCR  (Group  Control 

Record)  for  the  SYSOUT  group  or  master  index  backup 

Jobname 

The  name  of  the  job  that  originally  created  the  SYSOUT 
group 

JobID 

The  JOES  identifier  of  the  job  that  originally  created  the 
SYSOUT  group 

Generation  number 

The  archival  generation  of  the  SYSOUT  group 

Sequence  number 

The  sequence  number  of  the  SYSOUT  group  in  the 
generation 

Blocks 

Tlte  number  of  data  blocks  used  for  the  SYSOUT  group 

Continuation 

Indicator 

An  indicator  as  to  whether  the  SYSOUT  group  or  master 
index  is  continued  from  a  previous  backup  tape 

Continued 


Database  Utilities  7-31 


Tape  Copy  Utility  (SARTCP) 


Continued 


Field 

Contents 

SYSOUT  ID 

The  ID  of  the  SYSOUT  group  or  one  of  the  following  special 
identifiers: 

***INDX»** 

Represents  a  backup  of  the  master  index 

***  UNKN 

The  identity  of  the  SYSOUT  group  cannot 
be  determined  because  the  first  record  of 
the  group  is  not  a  control  record 

For  all  but  the  first  SYSOUT  group  on  the 
tape,  this  identification  indicates  a  problem 
with  the  group.  For  the  first  SYSOUT 
group  on  the  tape,  this  identification  is 
normal  when  the  SYSOUT  group  is  a 
continuation  of  the  group  from  the 
previous  tape. 

***  NULL  *** 

The  entry  represents  a  null  SYSOUT  group 
(that  is,  two  consecutive  tape  marks) 

A  null  entry  is  created  on  an  archival  tape 
by  the  NULL  control  statement. 

***  SKIP  *** 

The  SYSOUT  group  or  master  index  backup 
represented  by  the  entry  is  skipped  over  as 
requested  by  a  SKIP  control  statement 

Job  Control  Statements 

The  following  job  control  statements  are  necessary  to  execute  SARTCP: 


Control  Statement!  Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARTCP) 

STEPLIBDD 

Defines  the  load  library  containing  SARTCP. 

If  the  program  resides  in  a  fink  list  library,  omit  this 
statement 

SYSPRINT  DD 

Defines  the  sequential  output  data  set  (normally  SYSOUT) 
into  which  the  mapping  report  is  written 

If  not  a  SYSOUT  data  set,  DCB=BLKSIZE=nMM  must  be 
coded,  where  nnn  is  a  multiple  of  121. 

Continued 
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Control  Statement  Description 

TAPEIN  DD 

Defines  the  input  tape 

Generally,  the  tape  should  be  defined  with  standard  labels; 
however,  if  the  tape  has  been  damaged,  bypass  label 
processing  can  be  used. 

TAPEOUTDD 

Defines  the  output  tape 

This  statement  is  optional;  if  omitted,  no  tape  copy  is 
performed. 

SYSINDD 

Defines  a  card  image  data  set  containing  the  control 
statements 

SARTCP  Control  Statements 

Two  control  statements,  NULL  and  SKIP,  are  used  with  the  tape  copy  utility 
program. 


NULL 

U 


Syntax 


The  NULL  control  statement  is  used  to  write  a  null  SYSOUT  group  to  the  output 
tape.  For  example,  assume  an  I/O  error  exists  on  an  archival  tape  causing  the 
relative  positions  of  the  SYSOUT  groups  on  the  tape  to  be  thrown  off.  The  NULL 
statement  can  be  used  to  insert  a  null  SYSOUT  group  to  restore  correct 
positioning. 


NULIi  position-number 

where  position-number  specifies  the  desired  position  of  the  null  group.  It  may  be 
one  position,  or  a  range  of  positions  (for  example,  10-30). 

There  is  a  maximum  of  32K  NULL  statements  per  job. 
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SKIP 

The  SKIP  control  statement  is  used  to  skip  over  a  SYSOUT  group  on  the  input 
tape.  It  has  the  effect  of  deleting  die  group  or  groups  from  die  output. 

Syntax  skip  poaition'-nwnber 

where  position-number  specifies  the  position  of  the  SYSOUT  group  to  be  skipped^ 
It  may  be  one  position  represented  by  a  single  number,  or  a  range  of  positions 
represented  by  a  range  of  numbers  (for  example,  10-30). 

There  is  a  maximum  of  32K  SKIP  statements  per  job. 


SARTCP  Example 


Suppose  an  archival  tape  is  inadvertently  mounted  as  a  scratch  tape  for  a  job  and 
the  beginning  of  the  tape  is  overwritten.  In  order  to  recover  the  remaining 
SYSOUT  archived  on  the  tape,  do  the  following: 

1.  Run  the  following  job  to  map  the  tape: 

//TAPEH&P  JOB  ACCOUNT, PROGRAMMER 

//STEPl  EXEC  PGMaSARTCP 

//STEPLIB  DD  DSN<=CAI.GAlLIB,r>ISPsSHR 

//SYSPRINT  DD  SYSOOT=A,DCBs:BLKSIZE=!l21 

//TAPEIN  DD  DSN=VIEW.SARTAPE.T0000087,D1SP=OLD 

//SYSIN  DD  DUMMY 

The  following  mapping  report  is  produced: 


DATE:  06/29/95  16:52: 

25 

CA- 

VIEW 

(2.0)  -  TAPE 

COPY  UTILITY 

PAGE 

1 

INVOL : 

003467  INDSN: 

VIEW 

SARTAPE,T0000087 

OUTVOL : ; 

OUTDSN 

IN  POS 

OUTPOS  REC 

POS 

ID 

JOB  NAME 

JOB  ID 

GEN 

SEQ 

BLOCKS 

CONT 

1 

1 

***  UNKN 

3 

2 

2 

***  UNKN 

*** 

17 

3 

3 

***  UNKN 

*** 

3 

4 

4 

***  NULL 

★  ** 

0 

SARTCPIO 

INPUT  TAPE 

I/O  ERROR, ECB-41 

BLOCK  -0000000001, SENSE- 

2500 

5 

5 

***  UNKN 

*** 

6 

6 

■  '6 

8 

A06125ME 

A06125ME 

JOB09362 

128 

12 

2 

7 

7 

9 

A06128ME 

A06128ME 

JOB09368 

128 

12 

2 

8 

8 

10 

A21100R 

A21100R 

JOB09500 

128 

12 

2 

9 

9 

11 

A22110R, 

A22110R 

JOB09701 

128 

12 

2 

10 

10 

12 

***  INDX 

*** 

***  EOF 

*** 

SARTCP16 

PROCESSING  SUCCESFULLY  COMPLETED 
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From  the  preceding  report,  you  can  see  that  the  first  seven  SYSOUT  groups 
on  the  tape  have  been  destroyed,  since  the  first  valid  SYSOUT  group  has  a 
recorded  position  of  8. 


2.  To  recover  the  remaining  SYSOUT  groups,  run  the  following  job: 

//TAPECOPY  JOB  ACCOUNT, PROGSAHHER 
//STEPl  EXEC  PGM=SARTCP 

//STEPLZB  DD  £^=CAI.CAILIB,DISP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//TAPEIN  DD  DBN=VIEW.SARTAPE.T0000087, 

//  DISP=(OLD,UNCATLG) 

//TAPEOUT  DD  DSN=V1EW.SARTAPE.T0000087, 

II  DISP= { , GATLG) , UNIT=TAPE, LABEL=EXPDT=99  0  0  0 

//SYSIN  DD  * 

SKIP  1 
SKIP  2 
SKIP  3 
SKIP  4 
SKIP  5 
NULL  1 
NDBL  2 
NULL  3 
NULL  4 
NULL  5 
NULL  6 
NULL  7 
/* 


Tape  Management  Scratch  and  Clean  Utility  (SARTCHK) 

The  tape  management  scratch  and  clean  utility  (SARTCHK)  should  be  added  at 
the  end  of  your  tape  management  system's  scratch  and  clean  procedure. 
SARTCHK  verifies  that  every  active  tape  in  the  CA-View  database  is  still 
cataloged  imder  MVS. 


If  any  tapes  have  been  imcataloged,  a  list  of  the  missing  tapes  is  generated,  and  a 
condition  code  of  16  is  set,  indicating  that  your  tape  management  system  has 
scratched  tapes  still  required  by  CA-View.  The  tape  librarian  can  use  this  report 
to  prevent  the  tapes  from  being  overwritten,  and  data  being  lost. 

Code  one  step  for  each  CA-View  database  to  be  checked. 
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Job  Control  Statements 

The  folloAving  job  control  statements  are  necessary  to  execute  SARTCHK. 


Control  Statement 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARTCHK)  and  the 
high-level  name  of  the  CA-View  database  as  the  PARM 
parameter  (PARM='VIEW.SYSTEM1') 

STEPLIBDD 

Defines  the  load  library  containing  SARTCHK 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRINT  DD 

Defines  the  sequential  output  data  set  (normally 

SYSOUT)  into  which  the  listing  of  tmcataloged  tapes  is 
written 

If  not  a  SYSOUT  data  set,  DCB=BLKSIZE=nnn  must  be 
coded,  where  nnn  is  a  multiple  of  133. 

SYSUDUMP 

Defines  a  file  for  MVS  dump  output 

Restoring  a  Complete  Disk  Archival  Generation  (SARTDR) 

The  SARTDR  utility  can  be  used  to  recreate  and  reload  an  entire  archival  disk 
generation  from  tape.  In  addition,  the  utility  will  re-add  tape  archival  information 
to  the  master  index. 

The  utility  can  be  used  to  recover  one  or  more  generations  of  SYSOUT  data  that 
have  been  lost  due  to  one  of  the  following  conditions  (provided  error-free 
archival  tapes  exist  for  the  generations); 

■  Accidental  deletion  of  a  database  data  set 

■  Hardware  error  resulting  in  the  loss  of  a  database  data  set 

■  Accidental  or  intentional;  cycling  out  of  a  tape  or  disk  generation  from  within 
CA-View 

The  SARTDR  utility  does  not  require  exclusive  access  to  the  database;  it  can  run 
while  other  database  activities  such  as  archiving  or  backing  up  are  occurring. 
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Job  Control  Statements 

The  following  job  control  statements  are  necessary  to  execute  SARTDR. 


Control  Statement 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARTDR)  and  the 
high-level  name  of  the  CA-View  database  as  the  PARM 
parameter  (PARM='VIEW.SYSTEM1') 

STEPLIBDD 

Defines  the  load  library  containing  SARTDR 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRINT  DD 

Defines  the  sequential  output  data  set  (normally  SYSOUT) 
used  for  listing  the  statements  and  messages 

If  not  a  SYSOUT  data  set,  DCB=BLKSIZE=nwn  must  be 
coded,  where  nnn  is  a  multiple  of  121. 

anyname  DD 

Defines  one  archival  tape  to  be  re-added  to  the  master 
index  file 

The  DDname  must  match  the  one  that  is  specified  on  the 
TADD  control  statementi 

A  DD  statement  must  be  included  for  each  archival  tape  to 
be  re-added.  Omit  this  DD  statement  if  no  archival  tapes 
are  to  be  re-added. 

SYSINDD 

Defines  the  card  image  data  set  containing  the  control 
statements 

SARTDR  Control  Statements 

Control  statements  have  the  following  general  structure: 

/ function  parameters 

m  The  slash  is  coded  in  column  1  and  is  immediately  followed  by  the  name  of 
the  function  to  be  performed. 

■  One  or  more  blanks  must  follow  the  function  name  and  separate  the  function 
name  from  the  parameters.  Individual  parameters  are  separated  by  one  or 
more  blanks  and/ or  coirunas. 
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TADD 


Syntax 


■  A  statement  that  exceeds  71  characters  must  be  continued  on  additional 
cards.  When  continuing  a  statement,  interrupt  the  statement  only  between 
complete  parameters  or  subparameters. 

■  Comments  can  be  included  in  the  control  statements  by  coding  an  asterisk  in 
coliimn  1  of  the  card  image  containing  the  comment. 


The  TADD  control  statement  is  used  to  specify  an  archival  tape  that  is  tobe  re¬ 
added  to  the  master  index.  This  function  would  be  used  to  re-add  an  archival 
tape  that  has  cycled  out  of  CA-View. 

For  example,  assume  that  you  thought  you  were  keeping  100  generations  of 
SYSOUT  on  tape  but  in  actuality  you  were  only  keeping  90  (NGENT=90).  Any 
tapes  containing  SYSOUT  data  older  than  90  generations  ago  could  be  re-added 
to  the  master  index  with  this  function,  provided  that  the  tapes  had  not  been 
overwritten  since  they  had  been  cycled  out  of  GA-View.  Note  that  it  is  even 
possible  to  re-add  an  overwritten  tape  by  salvaging  it  first  with  the  SARTCP 
utility. 


/TADD  DDHAME^XXXXXXXX 

where  xxxxxxxx  specifies  the  name  of  the  DD  statement  used  to  define  the 
archival  tape  to  be  added  to  the  master  index. 

After  SARTDR  TADD  has  run,  you  should: 

■  Run  SARDBASE  VERIFY  to  build  the  alternate  index,  used  for  date  selection. 

■  If  you  have  ERO;  set  the  SARINIT  initialization  parameter  EROPRO  to  YES 
and  run  a  standard  backup. 

This  will' assign  the  appropriate  ERO  status  to  reports  from  previous 
generations.  For  more  information,  see  DSK2XXX  in  Chapter  2,  "Initialization 
Parameters." 

■  If  you  have  the  Expanded  Access  Server  and  you  recovered  the  tape  with 
SARTCP  SKIP  and  NULL  statements,  nm  SARPAG  on  the  recovered  tape. 

In  this  example.  Tape  VIEW.SYSTEM1.SARTAPE.T0000011  is  to  be  re-added  to 
the  master  index.  The  name  of  the  database  is  VIEW.SYSTEMl. 
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TLOAD 


Syntax 


Example  1 


The  following  job  is  nin: 

//EXAMPLE  JOB  AGCOTnn?,PROSSAHHER 
//STEPl  EXEC  PGM=SARTDR,PABM= 'VIEW. SYSTEM!' 
/ / STEPLIB  DD  DSM=CAI . CAILIB , DISP=SHR 

//SYSPRINT  DD  SYSOUT=* 

//TAPEIN  DD  VOL=SER=T00033,UNIT=TAPE, 

/ /  DSN=V1EW . SYSTEM! . SARTAPE . TO  0  0  0  0 !! , 

//  DISP=SHR 

//SYSIN  DD  * 

/TADD  DDHAME=TAPEZM 


The  TLOAD  control  statement  is  used  to  re-load  an  entire  disk  archival 
generation  from  tape,  or  the  entire  contents  of  a  tape.  Note  that  only  SYSOUT 
groups  originally  archived  to  disk  are  reloaded. 

Before  reloading  a  disk  archival  generation  with  this  function,  you  must  ensure 
that; 

■  All  archival  tapes  required  for  the  generation  are  known  to  CA-View.  Any 
tapes  not  known  to  CA-View  can  be  re-added  with  the  SARTDR  TADD 
control  statement. 

■  AH  archival  tapes  required  for  the  generation  are  available  and  error  free.  The 
SARTCP  utility  can  be  used  to  salvage  an  archival  tape  containing  errors. 


/TLOAD  GEN=linimn  TAPESEQ=SS£tSS 
where: 

nnnnn  Specifies  the  absolute  number  of  the  generation  for  which  SYSOUT 
is  to  be  reloaded  to  disk 

ssssss  Specifies  the  tape  sequence  number  of  the  backup  tape  for  which 

SYSOUTs  are  to  be  reloaded  to  disk 

If  the  last  SYSOUT  on  the  requested  tape  spans  mriltiple  tapes, 
SARTDR  will  request  additional  tape  moimts  to  reload  the  entire 
SYSOUT. 

If  both  generation  nximber  and  tape  sequence  number  are  specified,  SYSOUTS  for 
the  specified  generation  that  reside  on  the  specified  tape  will  be  reloaded  to  disk. 

In  this  example,  suppose  generation  1221  is  to  be  loaded  back  to  disk  from  the 
archival  tapes.  The  name  of  the  database  is  VIEW.SYSTEMl. 


Database  Utilities  7-39 


SYSOUTs  on  Tape  Utility  (SARTSLST) 


The  following  job  is  nm: 

//EXAUPLE  JOB  ACCOUNT, FE06RAHHER 
//BTEPl  EXEC  PGM=SARTDR,PARM='VIEW.SYSTEM1' 
//STEPLZB  DD  DSN=CAI.CAXI.ZB,DXSP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

/TDOAD  6EN=:12  21 
/* 


Example  2  In  this  example,  GA-View  backup  tape  AaEW.SYSTEMl.SARTAPE.T0000143  is  to 

be  loaded  back  to  disk.  The  name  of  the  database  is  VIEW.SYSTEMl. 


The  following  job  is  run: 

//EXAHPDE  JOB  ACCOUNT, PROGRAMMER 
//STEPl  EXEC  PGM=SARTDR,PAEM=' VIEW.SYSTEMl' 
/ /STEPLIB  DD  DSN=GAZ . CAZDIB, DISPOSER 
//SYSPRZNT  DD  SYSOUT=* 

//SYSIN  DD  * 

/TLOAD  TAPESEQ=143 
/* 


SYSOUTs  on  Tape  Utility  (SARTSLST) 

SARTSLST  creates  a  list  of  SYSOUTs  that  are  still  active  on  a  specific  tape  or  a 
range  of  tapes.  SARTSLST  reads  the  disk  database,  it  does  not  mount  any  tapes.  It 
lists  the  active  SYSOUTs  by  GA- View's  tape  sequence  number. 

If  a  tape  is  unreadable  or  lost,  you  can  use  this  utility  to  determine  any  active 
SYSOUTs  that  were  on  the  tape. 


Automatic  Re- Backup  or  Delete 

You  can  code  the  GTLGARDS  DD  statement  with  the  SARTSLST  job  to  have 

SARTSLST  automatically  generate  SARBGH  input  control  cards  to  clean  up  a  lost 

tape  from  the  database. 

Be  aware  of  the  following: 

■  If  the  SYSOUT  still  has  an  active  primary  disk  copy,  a  SARBGH  GHANGE 
statement  will  be  created  to  mark  the  SYSOUT  as  not  backed  up,  and  the  next 
backup  cycle  will  make  a  new  backup. 

■  If  the  SYSOUT  has  no  active  primary  disk  copy,  a  SARBGH  DELETE 
statement  will  be  created  to  delete  the  SYSOUT  from  the  database. 
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Note:  Do  not  use  SARTSIlST  if  you  use  tape  duplexing,  and  a  duplex  tape  is 
available  and  readable.  If  the  duplex  tape  was  created  with  3420  processing,  the 
SARTCP  utility  can  be  used  to  re-create  a  primary  from  the  duplex  tape,  and  no 
database  recovery  is  needed. 


Job  Control  Statements 

The  following  job  control  statements  are  necessary  to  execute  SARTSLST: 


Control  Statement 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARTSLST) 

The  PARM  parameter  specifies  the  high-level  name  of  the 
CA-View  database,  and  the  tape  sequence  number  to 
look  up  (for  example,  PARM=VIEW.SYSTEM1,14). 

STEPUIB  DD 

Defines  the  load  library  containing  SARTSIlST 

If  the  program  resides  in  a  link  list  library,  omit  this 
statement. 

SYSPRUMT  DD  Defines  the  sequential  output  data  set  (normally 

SYSOUT)  into  which  the  listing  of  uncataloged  tapes  is 
written 


If  not  a  SYSOUT  data  set,  DGB=BLKSIZE=nnn  must  be 
coded,  where  nnn  is  a  multiple  of  121. 


SYSUDUMP 

Defines  a  file  for  MVS  dump  output 

CTLCARDS 

Specifies  creation  of  SARBCH  statements  to  take  action 
on  the  SYSOUT:  either  back  it  up  again  or  delete  it  if 
there  is  no  disk  copy 

CA-View  Standard  Database  Access  Method  (SARSAM) 

User-defined  programs  running  under  MVS  can  access  the  CA-View  database  to 
retrieve  index,  SYSOUT,  and/ or  panel  data  via  the  CA-View  database  access 
method  (SARSAM). 
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The  subroutines  provided  to  access  the  GA-View  database  are  as  follows: 


Subroutine 

Description 

SAMOPEN 

Open  database 

SAMGLOSE 

Close  database 

SAMGET 

Get  index  record 

SAMINVL 

Invalidate  buffers 

SAMMSG 

Return  error  message 

SAMSOPEN 

Open  subfile 

SAMSGET 

Get  subfile  record 

SAMSCLS 

Close  subfile 

SARSAM 

Perform  SARSAM  access  method  request 

These  routines  can  be  called  from  any  prograiiuning  language  (such  as 
ASSEMBLER,  COBOL,  or  PLI)  using  standard  calling  conventions.  The  address 
of  a  parameter-list  is  placed  in  general  register  1,  the  return  address  is  placed  in 
general  register  14,  and  the  entry  point  address  is  placed  in  general  register  15.  In 
addition,  a  return-code  is  placed  in  general  register  15  on  exit  from  ea^  routine. 

The  SARSAM  routine  provides  an  alternate,  centralized  method  for  caUihg  the 
subroutines.  The  name  of  the  subroutine  is  passed  as  the  first  parameter  to  the 
subroutine  named  SARSAM. 

The  high-order  bit  of  the  last  parameter  address  pointed  to  by  general  register  1 
must  be  set  to  one  (if  the  called  routine  has  parameters).  This  calling  conversion  is 
automatically  supported  by  COBOL  and  PLL  With  Assembler,  the  CALL  macro 
must  be  explicitly  coded  with  the  VL  parameter. 

The  SARSAM  module  is  distributed  in  the  CAI.CAILIB  data  set  with  aliases  for 
entry  points  to  each  of  the  above  routines.  The  SARSAM  module  can  be  included 
in  the  user  defined  program  during  the  link-edit  phase.  Any  program  link-edited 
with  SARSAM  would  have  to  be  re  link-edited  when  a  new  version  of  CA-View 
is  installed.  As  an  alternative,  SARSAM  can  be  automatically  loaded  during  the 
execution  phase.  For  COBOL,  this  is  accomplished  by  specifying  DYNAM  during 
compilation. 

Mapping  macros  (record  definitions)  for  all  index  records  for  ASSEMBLER  and 
COBOL  programs  are  provided  in  the  VIEW.SOURCE  distribution  library. 
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SARSAM  Routines 

The  following  section  includes  complete  information  about  all  of  the  SARSAM 
routines  used  to  access  (he  database. 


SAMOPEN 


The  SAMQPEN  routine  opens  the  specified  database  and  establishes  all  the 
necessary  components  to  access  the  index  and  subfile  (SYSOUT  and/or  panel) 
data.  Only  one  database  can  be  accessed  at  one  time.  Any  database  that  was 
subsequently  opened  is  automatically  closed  before  opening  the  new  database. 

Calling  Parameters  ■  Address  of  a  17-byte  database  identifier 

■  Address  of  open  t}rpe  (optional) 

Return  Codes  Output  Return  Codes  (general  register  15): 

0  Database  successfully  opened 

4  Not  used 

8  Error  in  allocating/opening  the  database 

Calling  Example;  The  following  is  an  example  using  Assembler: 

Assembler 


CALL  SAHOPEN, (DATABASE) ,VL  OPEN  DATABASE 
LTR  15,15  CHECK  RETURN  CODE 

BNZ  DBERR 


DATABASE  DC - CL17 '  VIEW.SYSTEMl'  SAR  DATABASE 

Calling  Example:  The  following  is  an  example  using  COBOL: 

COBOL 


77  DATA-BASE-NAME  PIC  X( 17)  VALUE  'VIEW. SYSTEMl' . 


GALL  'SAMOPEN'  USING  DATA-BASE-NAME. 
IP  RETURN-CODE  NOT  =  ZERO 
60  TO  DBERR. 
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SAMCLOSE 

Calling  Parameters 
Return  Codes 


Calling  Example: 
Assembler 


Calling  Example: 
COBOL 


SAMGET 


Oalling  Parameters 


The  SAMCLOSE  routine  closes  a  previously-opened  database,  frees  all  buffers, 
and  frees  all  storage  obtained  to  process  data  in  the  CA-View  database. 

None 

Output  Return  Codes  (general  register  15): 

0  Database  successfully  closed 

4  Not  used 

8  Error  in  closing  the  database 

The  following  is  an  example  using  Assembler: 


CAI<L  SAMCLOSE  CLOSE  DATABASE 

LTR  15,15  CHECK  SETUEN  CODE 

BNZ  DBERR 


The  following  is  an  example  using  COBOL: 


CALL  'SAMCLOSE'. 

IF  RETURN-CODE  NOT  =  ZERO 
GO  TO  DBERR  . 


The  SAMGET  routine  searches  the  CA-View  database  for  a  qualifying  index 
record  and  returns  it  into  user  storage. 

■  Address  of  record  key  and  record  area 

■  Address  of  two-byte  (halfword)  record  area  length 
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■  Address  of  two-byte  search  type: 


'EQ'  Get  Equal 

'LT'  Get  Less  Than 

'GT'  Get  Greater  Than 

'LE'  Get  Less  Than  or  Equal 

'GE'  Get  Greater  Than  or  Equal 

■  Address  of  two-byte  (halfword)  area  to  return  the  actual  length  of  record 
(optional). 

Return  Codes  Output  return  codes  (general  register  15): 

0  Database  successhilly  read 

4  Record  not  found  or  end  of  file 

8  Error  reading  index 


■■  Calling  Example: 

Assembler 


The  following  is  an  example  using  Assembler: 


MVC 

GREe(16),=CL16'  ' 

BEGIN  WITH  FIRST  GCR 

GETKEC 

CALL 

SAHGET, (GREC, GRECL 

, GTYPE, GRETL),VL  GET  NEXT 

GH 

15,=H'4' 

CHECK  RETURN  CODE 

BE 

DBEOF 

BH 

DBERR 

• 

Process  GCR  record 

B 

GETREC 

GET  NEXT  INDEX  RECORD 

GREC 

DS 

CLCGCRLEN} 

STORAGE  FOR  GCR 

GRECL 

DC 

Y(GCELEN) 

LENGTH  OF  GCR 

GTYPE 

DC 

C'GT' 

GET  GREATER  THAN 

GRETL 

DS 

H 

RETURN  LENGTH  OF  GCR 
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Calling  Example: 
COBOL 


SAMINVL 


Calling  Parameters 
Return  Codes 


U 


The  following  is  an  example  using  COBOL: 


77 

RTNCODE 

PIG 

S9(8)  COMP. 

77 

GRECL 

PIC 

S9(4)  COMP  VALUE  +248 

77 

GTYPE 

PIG 

X(02)  VALUE  'GT'. 

77 

GRETL 

PIG 

S9  (4);  COMP. 

01 

GREC. 

05  GREC-REY 

PIG 

X(16) . 

05  GREC-DATA 

PIC 

X(232} . 

HOVE  SPACES  TO 

GREC- 

-KEY. 

GETREC . 

CALL  'SAHGET'  USXNG  GREC,  GRECL,  GTYPE,  GRETL^ 
MOVE  RETURN-CODE  TO  RTNCODE. 

IP  RTNCODE  >  4 
GO  TO  DBERR. 

IF  RTNCODE  =  4 
GO  TO  DBEOF. 

.  Process  GCR  record 


GO  TO  GETREC. 


The  SAMINVL  routine  causes  all  buffered  index  data  to  be  ignored  and  causes 
physical  reads  of  index  data  on  the  next  access  of  the  database.  Because  the 
CA-View  database  can  be  concurrently  updated  by  any  number  of  users,  the 
started  task  buffered  index  data  can  be  incorrect  or  outdated. 

This  situation  can  be  resolved  by  invalidating  buffers  and  re-reading  the  index 
data.  We  do  not  recommend  that  tiae  user  issue  an  invalidate  request  for  each 
index  record  that  is  retrieved  since  this  will  slow  down  access  to  the  database; 
however,  if  there  is  a  large  span  of  time  from  one  access  of  the  database  to 
another,  or  if  a  new  pass  of  the  index  is  to  be  invoked,  we  recommend  that  ani 
invalidate  request  be  issued. 

None 

Output  Return  Codes  (general  register  15): 

0  Successfulcompletion 

4  Not  Used 

8  Invalidation  failed 
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Calling  Example:  The  following  is  an  example  using  assembler: 

Assembler 


CALL  SAMIHVL  INVALinATE  BUFFERS 

LTR  15,15  CHECK  RETURN  CODE 

BNZ  DBERR 


Calling  Example:  The  following  is  an  example  using  COBOL: 

COBOL 


C2U.L  'SAMIHVL^. 

IF  RETURN-CODE  NOT  =  ZERO 
GO  TO  DBERR. 


SAMMSG 


The  SAMMSG  routine  returns  an  informational  or  error  message  to  user  storage 
describing  the  result  of  the  previously-invoked  SAM  routine.  If  the  previously- 
invoked  SAM  routine  had  a  successful  return  code,  the  message  returned  is 
blanks. 

Calling  Parameters  ■  Address  of  a  message  area 

■  Address  of  two-byte  (halfword)  message  area  length 

Return  Codes  Output  Return  Codes  (general  register  15): 

0  Successful  completion 

Calling  Example:  The  following  is  an  example  using  Assembler: 

Assembler 


DBERR 

CALL 

SAMMSG, (MS6,HSGL} ,VL 

GET  ERROR  MESSAGE 

HS6 

DC 

CLIOO'  ' 

MESSAGE  AREA 

MS6L 

DC 

Y(IOO) 

MESSAGE  LENGTH 

Database  Utilities  7-47 


SARSAM  Routines 


Calling  Example: 
COBOL 


SAMSOPN 

Calling  Parameters 
Return  Codes 


Calling  Example: 
Assembler 


The  following  is  an  example  using  COBGL: 


77  ERR-MSG  PIG  X(IOO)  VALUE  SPACES. 

77  ERRi-LEN  PIC  S9(4)  COMP  VALUE  +100. 


DBERR. 

CALL  'SAHHSG' 


USING  ERR^HSG, 


ERR-LEN. 


The  SAMSOPN  routine  opens  a  subfile  for  processing.  A  subfile  is  data  that  is 
chained  off  the  index  record  (SYSOUT  data  or  panel  data).  Any  subfile  that  was 
subsequently  opened  is  automatically  closed  before  opening  the  new  subfile. 

■  Address  of  GCR  (Group  Control  Record)  or  OCR  (Online  Control  Record) 

Output  Return  Codes  (general  register  15): 

0  Subfile  successfully  opened 

4  No  sub-file  for  record 

8  Subfile  not  opened 


The  following  is  an  example  using  Assembler: 


CALL 

SAMSOPN, (GREC) , VL 

OPEN  SUBFILE 

LTR 

15,15 

CHECK  RETXmN  CODE 

BNZ 

DBERR 

GREC 

DC 

CL<GCRLEN) 

GCR  RECORD  2UiEA 

GRECL 

DC 

Y(GCRLEN) 

GCR  RECORD  LENGTH 
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Calling  Example:  The  following  is  an  example  using  COBOL: 

COBOL 


77 

01 


GRECL 

GREC. 

PIC 

05 

GREC^KEY 

PIC 

05 

GREC^DATA 

PIC 

S9  (4)  COHP  VALUE  ■1.248. 

X(16) . 

X{232  )  . 


CALL  'SAHSOPN'  USING  GREC. 
IF  RETUSN-CODE  NOT  =  ZERO 
GO  TO  DBERR.. 


SAMSGET 

The  SAMSGET  routine  reads  and  returns  the  next  subfile  record  into  user 
storage. 

Calling  Parameters  ■  Address  of  a  record  area 

■  Address  of  two-byte  (halfword)  record  area  length 

■  Address  of  two-byte  (halfword)  area  to  return  the  actual  length  of  record 
(optional) 

Return  Codes  Output  Return  Codes  (general  register  15): 

0  Record  successful  read 

4  End  of  fUe 

8  Database  error 


Calling  Example:  The  following  is  an  example  using  Assembler: 

Assembler 


SFGET 


CALL 

CH 

BH 

BE 


SAUSGET, (REC,RECL,RETL) ,VL  GET  SUB-FILE  RECORD 
15,=H'4'  CHECK  RETURN  CODE 


DBERR 

DBEOF 


ERROR 

END  OF  FILE 


Process  record 


B  SFGET 


Continued 
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Calling  Example; 
COBOL 


SAMSCLS 


Calling  Parameters 


Return  Codes 


Calling  Example: 
Assembler 


Continued 

REC 

DC 

CL255'  ' 

RECORD  AREA 

RECL 

DC 

Y(255) 

RECORD  LENGTH 

RETL 

DS 

H 

RETURN  RECORD  LENGTH 

The  following  is  an  example  using  COBOL: 


77 

RTNCODE 

PIG 

S9(8) 

COMP. 

77 

REC -AREA 

PIC 

X{255) 

VALUE  SPACES. 

77 

REG-LEN 

PIC 

S9(4) 

COMP  VALUE  +255. 

77 

RET-LEN 

PIC 

S9  (4) 

COMP. 

SFGET. 

CALL  'SAHSGET'  USING  EEC -AREA,  REG^LEN,  RET-LEH. 
HOVE  RETURN-CODE  TO  RTNCODE. 

XF  RTNCODE  >  4 
GO  TO  DBERR. 

XF  RTNCODE  =  4 
GO  TO  DBEOF. 


GO  TO  SFGET. 


o 

The  SAMSCLS  routine  completes  processing  of  the  subfile  data,  frees  all  buffers, 
and  frees  all  storage  related  to  processing  of  the  subfile. 

None. 


Output  return  codes  (general  register  15): 

G  Subfile  successfully  closed 

4  Not  used 

8  Error  closing  subfile 

The  following  is  an  example  using  Assembler: 


CALL  SAHSCLS 
LTR  15,15 
BNZ  DBERR 


CLOSE  SUB-FILE 
CHECK  RETURN  CODE 
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/ 

Calling  Example:  The  following  is  an  example  using  COBOL: 

COBOL 


CALL  'SAMSCLS'. 

IF  RETURH-CODE  KOT  =  ZERO 
GO  TO  DBERR. 


SARSAM 


The  SARSAM  routine  provides  an  alternate,  centralized  method  for  calling  the 
subroutines  supported  by  the  SARSAM  access  method.  The  SARSAM  routine 
itself  simply  invokes  the  appropriate  subroutine. 

Calling  Parameters  Address  of  request  type: 


Return  Codes 


SAMOPEN 

SAMGLOSE 

SAMGET 

SAMINVL 

SAMMSG 

SAMSGET 

SAMSCLS 


Open  database 
Close  database 
Get  index  record 
Invalidate  buffers 
Return  error  message 
Open  subfile 
Close  subfile 


The  parameter  list  consists  of  the  address  of  the  request  type  followed  by  the 
parameters  required  by  the  routine.  As  an  example,  SAMOPEN  supports  two 
caUing  parameters:  the  address  of  a  17-byte  database  identifier,  and  the  address 
of  an  OPEN  t5rpe.  These  two  calling  parameter  addresses  should  follow  the 
address  of  the  character  string  SAMOPEN. 

Output  return  codes  are  dependent  on  the  routine  being  requested.  Refer  to  the 
appropriate  routine  for  information. 
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Calling  Example: 
Assembler 


Calling  Example: 
COBOL 


The  following  is  an  example  using  Assembler; 


CALL  SARSAH,  (OP&NItSQ,  DATABASE );,VL  OPEN  DATABASE 

LTR  R15,R15  CHECK  RETURN  CODE 

BN2  ERROR 


* 

6ETREC 


MVC  GHEC(16),=CL16"  BEGIN  WITH  FIRST  GCR 

GET  NEXT  RECORD 

CALL  SARSAH, (GETREQ, GREC, GRECL, GTYPE, GRETL) , VL 
CH  R15*=H'4' 

BE  EOF 
BH  ERROR 


.  Process  GCR  record 


ERROR 


B  GETREC 

CALL  SARSAH, (HSGREQ,HSG,HSGL) , VL  GET  HESSAGE 


.  PRINT  ERROR  MESSAGE 


EOF 


CALL  SARSAH, (GLOSEREQ),VL 
.  Terminate  Processing 


CLOSE  DATABASE 


OPENREQ  IX:  C'SAMOPEN' 

GETREQ  DC  C'SAHGET' 

HSGREQ  DC  C'SAHHSG' 

CLOSEREQ  DC  C'SAHCLOSE^ 
DATABASE  DC  CL17 'VIEH.SYSTEHl 
GREC  DS  CL(GCRLEN) 

GRECL  DC  Y(GCRLEN)) 

GRETL  DS  H 

GTYPE  DC  C'GT' 

HSG  DS  CLIOO 

HSGL  DC  H'lOO' 


OPEN  REQUEST  ROUTINE  NAME 

GET  REQUEST  ROUTINE  NAHE 

MESSAGE  REQUEST  ROUTINE  H2VHE 

CLOSE  REQUEST  ROUTINE  NAME 

DATABASE  NAME 

STORAGE  FOR  GCR 

LENGTH  OF  GCR 

RETURN  LENGTH  OF  GCR 

GET  GREATER  THAN 

MESSAGE  AREA 

LENGTH  OF  HESSAGE  AREA 


The  following  is  an  example  using  COBOL: 


77 

RTNCODE 

PIC 

S9(8)  COHP. 

77 

OPENREC 

PIC 

X(7)  VALUE  'SAHOPEN'. 

77 

GETREQ 

PIC 

X{6)  VALUE  'SAHGET'. 

77 

HSGREQ 

PIC 

X(6)'  VALUE  'SAHHSGr  . 

77 

CLOSEREQ 

PIC 

X(8)  VALUE  'SAHCLOSE'. 

77 

DATABASE 

PIC 

X(17)  VALUE  'VIEW.SYSTEHl' 

77 

GRECL 

PIG 

S9(4)  VALUE  +248. 

77 

GRETL 

PIG 

S9(4)  COMP. 

77 

GTYPE 

PIC 

X{2)  VALUE  'GT'. 

77 

HSG 

PIC 

X(IOO)  VALUE  SPACES. 

77 

HSGL 

PIG 

S9(4)  COHP  VALUE  +100. 

Continued 
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Continued 

01  6R£C. 

OS  GREC^-KBY  PIG  X{16)  . 

05  GREC-DATA  PIGX{232). 


CALL  'SARSAM'  USING  OPEMREQ^  DATABASE. 
HOVE  RETURN^CODE  TO  RTHCODE. 

IF  RTNCODE  HOT  =  0 
GO  TO  ERROR. 


HOVE  SPACE  TO  GREG -KEY. 

GETREC. 

CALL  'SARSAH'  USING  GETREQ^  GREG,  GRECL,  GTYPE,  GRETL. 
MOVE  RETURN-CODE  TO  RTNCODE. 

IF  RTNCODE  >  4 
GO  TO  ERROR. 

IF  RTNCODE  =  4 
GO  TO  EOF. 

.  Process  GCR  record 

GO  TO  GETREC. 

GETREC. 

CALL  'SARSAM'  USING  MSGREQ,  MSG,  HSGL. 

.  Print  Message 


EOF. 

CALL  'SARSAM'  USING  CLOSEREQ. 
.  Final  Processing 

STOP  RUN. 
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Chapter  8 

Backing  Up  and  Recovering  the 
Database 


In  This  Chapter 

This  chapter  covers  the  following  topics: 

■  Backup  and  recovery  concepts  and  procedures 

■  Minimizing  non-archival  time 

■  Using  third  party  backups 

■  Recovery  from  media  and  integrity  problems 

■  SARDBASE  RESTORE  with  and  without  forward  recovery  data 


Backup  and  Recovery 

To  assist  your  site  with  backup  and  recovery,  CA-View  provides  the  following 

features: 

■  Automatic  backup  of  the  current  disk  archival  generation  of  SYSOUT  and  the 
master  index  during  the  CA-View  backup  cycle 

■  Interim  backups  to  minimize  the  period  of  time  for  which  no  backup  exists 
on  tape 

■  Restoration  of  a  corrupted  database  with  the  SARDBASE  RESTORE  and 
SARRSP  programs 

■  Restoration  of  a  complete  generation  of  SYSOUT  data  from  tape  to  disk  with 
the  SARTDR  program 

■  Tape  mapping,  copying,  and  salvaging  with  the  SARTCP  program 

■  Forward  recovery,  which  provides  recovery  of  SYSOUTs  that  were  archived 
after  the  last  backup  of  the  database 

Diuing  tape  backup,  the  tape  is  cataloged  when  the  tape  is  opened. 
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Backing  Up  the  CA-View  Database 


As  part  of  its  backup  cycle,  GA-View  optionally  backs  up  to  tape  the  cunent  disk 
ardhive  generation  of  SYSOUT,  along  with  the  master  index.  The  TBACKUP 
initialization  parameter  determines  whether  backups  are  done. 

CA-View  also  allows  you  to  produce  a  duplicate  of  its  backup  tapes.  A 
subparameter  of  the  STORGRPn  parameters  (imit2-name)  determines  whether 
tape  duplexing  is  done. 

If  you  define  tape  storage  groups  with  the  STORGRPn  initialization  parameters, 
we  recommend  that  you  make  STORGRPl  the  largest  group,  to  enhance  the 
perfonnance  of  the  backup  cycle. 

The  master  index  contains  the  location  and  attributes  of  all  archived  SYSOUT; 
therefore,  we  strongly  recommend  that  CA-View  be  allbwed  to  automatically 
back  up  the  master  index.  The  master  indfex  is  always  backed  up  to  the  tape 
storage  group  defined  by  the  initialization  parameter  STORGRPO. 


Annotation  Backup 

AU  annotations  will  automatically  be  backed  up  to  tape  during  the  normal 
backup  cycle.  Like  resources  for  AFP  and  Xerox  reports,  the  annotations  will 
remain  on  disk  until  the  report  is  deleted  from  the  system  either  manually  or  due 
to  migration  rules. 

If  a  report  is  deleted  from  the  system,  aimotations  cannot  be  recovered  with  the 
tape  utility. 


Using  Other  Backup  Products 

If  you  use  another  vendor's  backup  product  (such  as  FDR,  DFDSS,  etc.)  to  back 
up  the  CA-View  database,  you  must  ensure  that  the  database  is  not  updated 
during  the  backup,  and  that  the  entire  database  is  backed  up. 

If  a  database  spans  mxiltiple  volumes,  full  volume  backups  must  be  performed.  If 
the  database  needs  to  be  restored,  all  data  sets  comprising  the  database  must  be 
restored  from  the  same  backup.  If,  for  example,  a  volume  containing  part  of  the 
database  crashes,  and  updates  have  occurred  since  the  backup>  you  cannot 
restore  only  that  volume. 


Warning!  It  a  tape  manai'enu  nt  Mem  installed  eiisujc  that  t  \-\  n  u  s 
tape  p^tention  critena  cannot  be  o\  firidden  by  tht  tiipc  manaciomont  svsti.>m 
with  respect  to  abnormal  termination  (AliF.NTDS) 
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Backup  and  Recovery  Guidelines 


Forward  Recovery  If  you  have  not  activated  forward  recovery  data  set  (RDS),  all  SYSOUT  that  was 

and  Interim  Backups  archived  after  the  most  recent  standard  or  interim  backup  cannot  be  recovered; 

therefore,  if  you  do  not  use  forward  recovery  data  set,  it  is  important  that 
interim  backups  be  performed. 


Darnaged  and  The  SARTCP  utihty  can  be  used  to  salvage  SYSOUT  from  a  damaged  tape.  The 

Missing  Tapes  utility  maps  the  contents  of  copies,  and  reconstructs  a  backup  archival  tape. 

STARTSIlST  can  be  used  to  delete  references  to  a  missing  tape. 


Reloading  From  Ttape  The  SARTDR  utility  can  be  used  to  recreate  and  reload  an  entire  disk  archival 
generation  from  tape.  Facilities  are  also  available  with  the  utility  to  re-add  tape 
archival  information  back  to  the  master  index. 


Recovery  and  CA-View  automatically  backs  up  the  master  index  to  tape  as  part  of  its  backup 

Archival  Resumption  cycle  and  maintains  inf ormation  on  the  backups  m  the  recovery  data  set.  In  case 

of  loss  or  destruction  of  the  master  index,  the  database  can  be  restored  from  one 
of  the  backups  using  the  RESTORE  function  of  the  SARDBASE  program. 

The  SARDBASE  RESTORE  function  does  the  following: 

■  Restores  the  master  index  from  the  appropriate  backup  tape 

■  Optionally  copies  the  archived  SYSOUT  from  the  old  database 

SYSOUT  archival  cannot  occur  during  the  SARDBASE  RESTORE  preliminary 
phase  (master  index  restore),  but  archival  can  be  resumed  during  the  data  restore 
phase.  The  SARDBR17  console  message  notifies  you  when  the  preliminary  phase 
has  completed  and  informs  you  that  you  can  bring  up  the  CA-View  started  task 
to  resume  archival. 


Alternatively,  you  can  have  SARDBASE  RESTORE  restore  only  the  master  index; 
then  you  can  use  SARRSP  to  restore  SYSOUTs  from  tape.  Archival  can  resume 
while  SARRSP  is  running. 


Forward  Recovery 

With  forward  recovery  data  set  activated,  all  SYSOUT  data  archived  by  the 
CA-View  started  task  is  also  stored  in  forward  recovery  data  sets.  If  a  database 
needs  to  be  restored,  you  camrecover  the  SYSOUT  data  that  was  archived  by  the 
CA-View  started  task  after  the  last  backup.  (Forward  recovery  does  not  include 
SYSOUT  written  to  the  database  by  CA-Deliver  direct-to-CA-View  archival.) 

You  activate  forward  recovery  data  set  with  initialization  parameters  (RCVPRIM, 
RCVSEC,  RCVSPACE,  and  RCVUNIT). 
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When  you  specify  values  for  these  parameters  and  run  SARINIT,  the  next 
CA^View  backup  cycle  allocates  the  forward  recovery  data  sets.  Subsequent 
backups  delete  old  forward  recovery  data  sets  and  allocate  new  ones. 

If  you  need  to  restore  the  CA-View  database  from  backup  tapes,  the  SYSOUTs 
residing  in  the  forward  recovery  data  sets  are  automatically  written  to  the 
restored  CA-View  database. 

If  you  do  not  have  values  for  the  forward  recovery  data  set  parameters,  forward 
recovery  data  set  is  inactive. 


Forward  Recovery  Data  Set  Format 

The  forward  recovery  data  sets  are  compressed,  manageable  by  SMS,  and  have  a 
record  format  of  U  (rmdefined  length  records),  a  block  size  of  32760,  and  a 
DSORG  of  PS  (physical  sequential).  The  data  set  naming  convention  is: 

high~  level  -prefix.  SARPRDS  .  Dnnamma 
where: 

nnnnnnn  is  a  sequentially-incremented  number  that  starts  at  1. 


Forward  Recovery  Data  Set  Operation 

The  forward  recovery  data  set  (RDS)  stores  the  SYSOUT  data  that  is  archived 
during  and  after  a  backup  cycle  (standard  or  interim).  It  also  stores  the  master 
control  records  (MGR),  tape  control  records  (TCR),  and  group  control  records 
(GCR)  of  the  database. 

If  an  RDS  becomes  full,  a  new  RDS  with  the  next  sequential  number  is 
automatically  created  by  the  CA-View  archival  task.  The  starting  and  ending  RDS 
numbers  are  tracked  in  the  CA-View  database. 

When  a  CA-View  backup  begins,  a  new  RDS  with  the  next  sequential  number  is 
automatically  created.  When  the  backup  has  successfully  completed,  the  RDSs 
that  contain  data  from  before  the  current  backup  are  deleted. 

When  SARDBASE  RESTORE  runs,  it  determines  if  there  are  any  active  RDSs.  If 
active  RDSs  are  foimd,  RESTORE  copies  the  SYSOUT  data  from  the  RDSs  to  the 
database  it  has  restored  automatically. 

Forward  recovery  enables  successful  recovery  from  an  unlimited  number  of 
nested  failures,  including  failures  which  can  occur  during  the  recovery  process. 

Each  RDS  begins  with  controliinformation.  Because  a  SYSOUT  group  can  consist 
of  multiple  JES  data  sets,  the  control  information  includes  a  pointer  to  the  end  of 
the  last  successfully  stored  JES  data  set. 
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If  the  CA-View  started  task  is  interrupted  and  must  be  started  again;  the  forward 
recovery  data  set  storage  process  resumes  with  the  next  data  set  presented  by 
JES.  If  the  interruption  occurred  while  CA-View  was  processing  a  JES  data  set  in 
the  middife  of  a  SYSOUT  group,  JES  presents  that  same  "middle"  data  set  to  the 
CA-View  archival  started  task,  and  the  forward  recovery  data  set  storage  process 
correctly  appends  that  data  set  to  the  data  sets  that  preceded  it. 


Forward  Recovery  Messages 

Information  messages  and  error  messages  about  the  forward  recovery  data  sets 
are  written  via  WTO  to  the  master  console  (ROUTCDE=l,  DESC=7).  Ihformation 
messages  identify  the  creation  and  deletion  of  the  RDSs,  and  error  messages 
identify  any  unusual  conditions  that  arise  during  access  of  the  RDSs. 


Activating  Forward  Recovery 

The  space  allocation  (primary,  secondary,  and  type)  and  unit  name  of  the 
forward  recovery  data  sets  are  defined  and  enabled  with  the  following 
initialization  parameters: 


Initialization 

Parameter 

Description 

RCVPRIll=iinrLa 

Specifies  the  primary  space  allocation  for  the  forward  recovery 
data  sets 

This  parameter  activates  the  forward  recovery  data  set;  with 
the  next  backup  cycle,  forward  recovery  data  sets  will  be 
created. 

RGVSEC=jiimn 

Specifies  the  secondary  space  allocation  for  the  forward 
recovery  data  sets 

This  optional  parameter  is  used  when  the  primary  space 
aUocation  is  exhausted. 

RCVSPAGE= 

TRKSjCYLS 

Specifies  whether  the  space  allocation  for  the  forward  recovery 
data  sets  are  to  be  obtained  in  tracks  (TRKS)  or  cylinders 
(GYLS) 

The  default  space  allocations  is  tracks.  This  parameter  is 
optional. 

Continued 
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Continued 

Initidlization 

Parameter 

Description 

RGVtJNIT=  uni  t 

Specifies  the  unit  name  or  unit  type  where  the  forward 
recovery  data  sets  are  to  be  aEocated 

This  parameter  is  required  for  the  forward  recovery  data  set  to 
be  activated.  You  should  verify  that  the  forward  recovery  data 
sets  are  not  allocated  on  the  same  volumes  on  which  the 
CA-View  database  resides. 

Backup  Cycle  Consideration 

If  a  backup  cycle  was  in- progress  when  the  started  task  was  last  executing,  and  if 
you- restored  the  database  using  the  forward  recovery  data  set,  resuming  the 
started  task  will  result  in  an  immediate  backup  cycle. 

If  no  archival  occurred  since  the  last  backup  cycle,  the  MCR  in  the  forward 
recovery  data  set  indicates  that  a  backup  cycle  was  in  progress.  Resuming  the 
started  task  will  result  in  an  immediate  backup  cycle.  If  this  is  a  primary  backup, 
the  generation  number  wiE  increment. 


Database  Recovery  Utilities 

CA-View  provides  several  database  utEities  to  facEitate  the  recovery  process. 


SARDBASE  Utility 


In  the  SARDBASE  utiEty: 

■  The  VERIFY  control  statement  verifies  and  corrects  the  database  (including 
broken  pointer  chains). 

■  The  COPY  control  statement  copies  a  database. 

■  The  UNILOAD  control  statement  urEoads  a  database  to  tape. 

■  The  LOAD  control  statement  reloads  a  database  from  tape. 

■  The  MERGE  control  statement  merges  one  or  more  databases.  (This  requires 
the  Expanded  Retention  Option.) 

■  The  RESTORE  control  statement  restores  the  database  master  index  from 
tape  (and  optionaEy  copies  SYSOUT  data  from  the  old  database). 
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SARRCOV  Utility 


The  SARRCOV  utility  enables  you  to  list  or  recreate  the  recovery  data  set. 

The  recovery  data  set  is  used  by  the  RESTORE  control  statement  to  properly 
process  a  CA-View  database  master  index  which  spans  multiple  tape  volumes. 


SARRSP  Utility 

The  SARRSP  utility  enables  you  to  repopulate  the  database  from  tape. 

SARTDR  Utility 

The  SARTDR  utility  enables  you  to  restore  specific  generations  from  tape. 
SARTDR  can  also  restore  index  information  from  tape. 

STARTSLST  Utility 


The  STARTSLST  utility  enables  you  to  eliminate  references  to  destroyed  backup 
tapes. 


Recovery  Procedures 

You  can  recover  a  CA-View  database  in  the  following  situations: 

■  Recovery  from  media  problems 

■  Recovery  from  integrity  problems 

■  Restoring  the  entire  database  with  SARDBASE  RESTORE 

■  Recovery  using  forward  recovery  data  set  data 

See  Chapter  7,  "Database  Utilities,"  for  complete  descriptions  of  the  utilities  used 
in  all  of  these  recovery  procedures. 

Note:  If  you  use  CA-Deliver  direct-to-CA-View  archival,  you  can  temporarily 
re-route  the  reports  to  the  JES  spool  via  the  CA-Deliver  ARCHn  parameters. 
When  the  CA-View  archival  task  is  restarted,  it  will  archive  those  reports  from; 
JES. 
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Minimizing  Non-Archival  Time 

Certain  database  recovery  processes  can  take  a  considerable  amount  of  time, 
depending  on  the  size  of  the  database.  You  can  minimize  non-archival  time 
during  database  recovery  by  restoring  the  database  in  phases.  After  the  first 
phase  (master  index  restore),  you  can  restune  archival. 

If  a  SARDBASE  RESTORE  is  required  for  a  database  you  can: 

■  Initially  RESTORE  only  the  master  index  (substantially  less  time  than 
restoring  all  data) 

■  Use  the  TLOAD  control  statement  of  the  SARTDR  to  restore  the  number  of 
generations  you  require  for  production 

■  Resume  operation  of  the  CA-View  archival  task,  archiving  to  the  newly- 
restored  database 

■  Use  SARRSP  to  restore  the  rest  of  the  corrupted  database  to  the  newly- 
restored  database 

This  can  be  done  during  archival. 


Using  Third-Party  Backups 

If  the  database  was  backed  up  with  a  third-party  product,  do  the  following  to 
recover  the  database: 

1.  Restore  the  database  from  a  valid  backup. 

A  valid  backup  requires  that  all  data  sets  comprising  the  database  were 
backed  up,  and  the  database  was  not  updated  during  the  backup. 

2.  Use  SARTDR  TADD  to  add'  GA-View  backup  tapes  created  since  the  backup 
used  for  Step  1. 

3.  Use  SARTDR  TLOAD  to  load  generations  needed  for  production. 

4.  After  SARTDR  TLOAD  has  run,  do  the  following: 

■  Rim  SARDBASE  VEBflFY  to  build  the  alternate  index  used  for  date 
selection. 

■  Set  CA-View  initialization  parameter  EROPROto  ALL  prior  to  the 
standard  backup  cycle. 

5.  Restart  the  CA-View  archival  task  and  resume  operation. 
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COPY  Disk-to-Disk 


Perform  the  following  procedure  to  recover  the  database  from  a  media  problem: 

1.  Run  the  SARDBASE  utility  ADDDS  function  to  create  a  new  database  on 
alternate  DASD. 

2.  Run  the  SARDBASE  utility  COPY  function  to  copy  the  data  from  the  old 
(damaged)  database  into  Ae  new  database. 

You  can  choose  to  run  SARBCH  LIST  on  the  old  and  new  databases,  to 
accoxmt  for  any  data  that  may  have  been  lost  in  the  process. 

3.  If  necessary,  you  can  restore  lost  data  from  backup  tapes  using  SARTDR 
TADD. 

The  output  from  SARBCH  LIST  shows  the  tape  sequence  number  for  each 
SYSOUT.  The  tape  sequence  number  is  part  of  the  last  qualifier  of  the  tape 
data  set  name,  used  by  SARTDR  TADD. 

Note:  If  many  SYSOUTs  are  missing,  you  can  save  time  by  using 
SARDBASE  RESTORE  as  an  alternative  to  SARTDR  TADD. 

See  the  sections  Minimizing  Non- Archival  Time  (earlier  in  this  chapter), 
SARDBASE  RESTORE  Using  Forward  Recovery  Data  (later  in  this  chapter), 
and  SARDBASE  RKTORE  Without  Forward  Recovery  Data  (later  in  this 
chapter). 

4.  After  SARTDR  TADD  has  run,  you  should  do  the  following: 

■  Run  SARDBASE  VERIFY  to  build  the  alternate  index,  used  for  date 
selection. 

■  Set  CA-View  initialization  parameter  EROPRO  to  ALL  prior  to  the 
standard  backup  cycle. 

5.  Restart  the  CA-View  archival  task  and  resume  operation. 


Recovery  From  Media  Problems 

The  following  error  message  indicates  possible  media  corruption: 

SAHDBZ02  PHYSICAL  I/O  ERROR  -  ECB=xxxxxxxx 


You  can  resolve  this  media  error  without  using  SARDBASE  RESTORE  to  restore 
the  database.  Instead,  you  can  use  either  SARDBASE  COPY  or  SARDBASE 
UNLOAD  and  LOAD.  In  most  cases,  these  processes  involve  minimal  data  loss. 

If  you  determine  that  there  is  not  a  media  problem,  continue  with  the  instructions 
in  the  section  Recovery  From;  Integrity  Problems  later  in  this  chapter. 
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UNLOAD  to  Tape  and  LOAD  Back 

If  the  database  encoiintered  a  media  problem,  do  the  following  to  recover  the 
database: 

1.  Rim  the  SARDBASE  utility  UNLOAD  function  to  unload  the  database  to 
tape. 

You  may  choose  to  nm  SARBCH  LIST  before  the  UNLOAD  and  after  the 
LOAD;  to  account  for  any  data  that  may  have  been  lost  in  the  process. 

2.  Run  the  SARDBASE  utility  ADDDS  function  to  create  a  new  database  on 
alternate  DASD. 

3.  Rrm  the  SARDBASE  utility  LOAD  function  to  reload  the  data  from  tape 
(from  the  UNLOAD)  to  the  new  database. 

4.  If  necessary,  you  can  restore  lost  data  from  backup  tapes  using  SARTDR 
TADD. 

The  output  from  SARBCH  LIST  shows  the  tape  sequence  munber  for  each 
SYSOUT.  The  tape  sequence  number  is  part  of  the  last  qualifier  of  the  tape 
data  set  name,  used  by  SARTDR  TADD. 

Note:  If  many  SYSOUTs  are  missing,  you  can  save  time  by  using 
SARDBASE  RESTORE  as  an  alternative  to  SARTDR  TADD. 

See  the  sections  Miriirruzing  Non-Archival  Time  (earlier  in  this  chapter), 
SARDBASE  RESTORE  Using  Forward  Recovery  Data  (later  in  this  chapter), 
and  SARDBASE  RESTORE  Without  Forward  Recovery  Data  (later  in  this 
chapter). 

5.  After  SARTDR  TADD  has  run,  do  the  following: 

■  Run  SARDBASE  VERIFY  to  build  the  alternate  index  used  for  date 
selection. 

■  Set  the  EROPRO  initialization  parameter  to  ALL  prior  to  the  standard 
backup  cycle. 

6.  Restart  the  CA-View  archival  task  and  resume  operation. 


COPY  Disk-to-Disk 


If  the  database  encoimtered  a  media  problem,  do  the  following  to  recover  the 
database: 

1.  Rim  the  SARDBASE  utility  ADDDS  function  to  create  a  new  database  on 
alternate  DASD. 

2.  Run  the  SARDBASE  utility  COPY  function  to  copy  the  data  from  the  old 
(damaged)  database  into  the  new  database. 

You  may  choose  to  run  SARBCH  LIST  on  the  old  and  new  databases,  to 
account  for  any  data  that  may  have  been  lost  in  the  process. 
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3.  If  necessary,  you  can  restore  lost  data  from  backup  tapes  using  SARTDR 
TADD. 

The  output  from  SARBCH  LIST  shows  the  tape  sequence  number  for  each 
SYSOUT.  The  tape  sequence  number  is  part  of  the  last  qualifier  of  the  tape 
data  set  name,  used  by  SARTDR  TADDj 

Note:  If  many  SYSOUTs  are  missing,  you  can  save  time  by  using 
SARDBASE  RESTORE  as  an  alternative  to  SARTDR  TADD. 

See  the  sections  Minimizing  Non- Archival  Time  (later  in  this  chapter), 
SARDBASE  RESTORE  Using  Forward  Recovery  Data  (later  in  this  chapter), 
and  SARDBASE  RESTORE  Without  Forward  Recovery  Data  (later  in  this 
chapter). 

4.  After  SARTDRTADD  has  run,  you  should  do  the  following: 

■  Rim  SARDBASE  VERIFY  to  build  the  alternate  index,  used  for  date 
selection. 

■  Set  the  EROPRO  initialization  parameter  to  ALL  prior  to  the  standard 
backup  cycle. 

5.  Restart  the  CA-View  archival  task  and  resume  operation. 


,  Recovery  From  Integrity  Problems 

The  following  error  messages  indicate  record  corruption: 

SARDBI03  DATASET  NUMBER  OUT  OF  RANGE  -  DCCB=XXXXXXXX 
SARDBI09  IiOGICAI.  I/O  ERROR 

These  errors  can  be  resolved  without  using  SARDBASE  RESTORE  to  restore  the 
database.  These  can  be  solved  with  either  SARDBASE  VERIFY,  COPY,  or 
UNLOAD  and  LOAD.  In  most  cases,  these  processes  involve  minimal  data loss. 

The  following  problems  may  indicate  database  corruption  that  should  be 
resolved  if  you  use  this  recovery  procedure: 

■  Date  selection  problems 

■  Loop  in  the  SYSOUT  Selection  List  panel 

■  Loop  during  the  CA-View  archival  task  backup  cycle 

■  Loop  while  executing  database  utilities 

■  Difficulty  deleting  SYSOUT  groups 
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Recovery  Steps 


If  your  database  encountered  the  previously-mentioned  errors  or  symptoms,  do 
the  following  to  recover  the  database: 

1.  Run  the  SARDBASE  utility  VERIFY  function  to  verify  and  correct  the 
database. 

You  may  choose  to  run  SARBCH  LIST  before  and  after  the  VERIFY,  to 
accoimt  for  any  data  that  may  have  been  lost  in  the  process. 

2.  If  necessary,  you  can  restore  lost  data  from  backup  tapes  using  SARTDR 
TADD. 

The  output  from  SARBCH  LIST  shows  the  tape  sequence  number  for  each 
SYSOUT.  The  tape  sequence  number  is  part  of  the  last  qualifier  of  the  tape 
data  set  name  used  by  SARTDR  TADD; 

Note:  If  many  SYSOUTs  are  missing,  you  can  save  time  by  using 
SARDBASE  RESTORE  as  an  alternative  to  SARTDR  TADD: 

See  the  sections  Minimizing  Non- Archival  Time  (earlier  m  this  chapter), 
SARDBASE  RESTORE  Using  Forward  Recovery  Data  (later  in  this  chapter), 
and  SARDBASE  RESTORE  Without  Forward  Recovery  Data  (later  m  this 
chapter). 

3.  After  SARTDR  TADD  has  run,  do  the  following: 

■  Rim  SARDBASE  VERIFY  again,  to  build  the  alternate  index  used  for  date 
selection. 

■  Set  the  EROPRO  initialization  parameter  to  ALL  prior  to  the  standard 
backup  cycle. 

4.  Restart  the  CA-View  archival  task  and  resume  operation. 

If  additional  errors  remain  after  the  VERIFY,  see  Recovery  From  Media  Problems, 
earlier  in  this  chapter. 


SARDBASE  RESTORE  Using  Fonvard  Recovery  Data 

If  you  have  implemented  forward  recovery  data  set,  you  can  add  any  data 
written  to  the  forward  recovery  data  sets  to  your  newly  restored  database. 

1.  Use  SARDBASE  RENAME  to  rename  the  damaged  CA-View  database  to  a 
new  name. 

Note:  The  RDSs  do  not  get  renamed,  so  they  can  be  used  in  the  SARDBASE 
RESTORE. 
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2.  Use  SARDBASE  ADDDS  to  create  a  new  target  CA-View  database  with  the 
original  name. 

The  hight-level  prefix  name  of  the  RDSs  must  correspond  to  the  high-level 
prefix  name  of  the  target  GA-View  database. 

3;  Use  SAMDBASE  RESTORE  to  restore  the  CA-View  database  index  to  the  new 
target  CA-View  database  (forward  recovery  data  sets  will  only  be  accessed  if 
the  most  current  backup  is  used);  the  following  occurs: 

■  The  MGR>  TCR,  PCR,  ECR,  and  UGR  are  restored  from  the  backup  tape. 

■  The  MGR  and  TCR  are  restored  from  the  RDS. 

■  The  MGR  is  marked  so  that  no  backups  can  occur  and  a  new  RDS  will  be 
created. 

■  Message  SARDBR17  informs  you  that  the  index  has  been  restored,  and 
you  can  start  the  CA-View  archival  started  task.  When  you  start  the  task, 
the  new  RDS  will  be  created. 

4.  Rim  SARDBASE  OLOAD  to  get  panels  into  the  new  database.  Online 
viewing  can  now  resume  and  the  following  occurs: 

■  SYSOUTs  which  are  intact  from  the  damaged  CA-View  database  are 
copied  to  the  new  target  CA-View  database  and  each  GCR  is  restored 
followed  by  its  SYSOUT  data. 

■  SYSOUTs  are  copied  from  the  RDSs  to  the  new  target  CA-View  database 
and  each  GCR  is  restored  followed  by  its  SYSOUT  data. 

When  all  RDSs  have  been  processed,  the  MGR  is  marked  so  that  normal 
backups  can  occur. 

5.  Use  the  SARRSP  recovery  utility  program  to  copy  any  SYSOUTs  still missing 
from  the  new  target  GA-View  disk  database  from  backup  tapes. 


SARDBASE  RESTORE  Without  Forward  Recovery  Data 

If  the  database  is  lostor  damaged,  and  all  attempts  to  recover  it  have  failed>  itcan 
be  recovered  from  backup  tapes  as  follows: 

1.  Run  the  SARDBASE  utility  ADDDS  function  to  create  a  new  database. 

In  cases  where  the  oid  database  has  to  be  deleted  due  to  insufficient  disk 
requirements  for  the  new  database,  provide  an  alternate  means  of  backup  for 
the  database,  such  as  FDR  or  DFDSS. 

2.  Run  the  SARDBASE  RKTORE  function. 

The  SARDBR17  console  message  notifies  you  when  the  preliminary  phase 
has  completed  and  informs  you  that  you  can  bring  up  the  CA-View  started 
task  to  resume  archival.  An- alternative  is  to  restore  only  the  master  index, 
and  then  use  SARRSP  and/or  SARTDR  TLO AD  to  restore  the  SYSOUT  data. 
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The  SARDBASE  RESTORE  JCL  must  specify  a  SARRECV  or  SARTAPE  DD 
statement  for  purposes  of  locating  the  backup  tapes. 

Note:  The  RESTORE  operation  must  be  performed  against  a  newly  created, 
empty  database.  It  is  not  necessary  to  reinstate  any  initialization  parameters 
because  these  parameters  are  recovered  during  the  restore  process. 

3.  Run  the  SARDBASE  utility  OLOAD  function  to  load  all  online  members  to 
the  new  database. 

4.  If  the  old  database  was  not  used  in  the  restore  process,  run  either  SARRSP  or 
SARTDR  TLOAD  to  load  the  SYSOTJT  data;  you  can: 

■  Use  SARTDR  TLOAD  to  load  one  or  two  generations  of  data. 

■  Restart  the  CA-View  archival  task  and  resume  operation. 

■  Rim  SARRSP  to  restore  the  remaining  data. 
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Chapter  9 
Batch  Processing 


In  This  Chapter 

This  chapter  discusses  the  SARBCH  program,  which  performs  batch  retrieval 
functions. 


Batch  Retrieval  With  SARBCH 

CA-View  provides  batch  retrieval  facilities  with  its  SARBCH  program.  SARBCH 
performs  the  following  functions  in  batch,  each  of  which  is  explained  later  in  this 
chapter: 


SARBCH  Function 

Description 

BPRINT 

Reprints  an  archived  CA-Deliver  bundle 

CHANGE 

Changes  the  backup,  print,  and  user  attributes  of  an 
archived  SYSOUT 

DBASE 

Specifies  the  CA-View  database  to  be  used 

DEFDIST 

Creates  or  modifies  the  SYSOUT  IDs  for  a  DIST  ID 

DEFSYS 

Creates  or  modifies  the  DIST  IDs  for  SYSOUT  IDs 

DEFUSER 

Adds  or  modifies  user  IDs 

DELETE 

Deletes  a  SYSOUT,  a  user  ID,  or  a  logical  view 

EPRINT 

Prints  reports  archived  directly  from  CA-Deliver 

EXTRACT 

Marks  a  report  to  have  data  extracted  by  the  Computer 
Associates  balancing  product,  CA-Balancing 

INDEX 

Produces  a  page  index  for  an  archived  SYSOUT 

LIST 

Produces  a  listing  of  SYSOUTs  or  user  IDs 

LOAD 

Loads  a  SYSOUT  from  tape  to  disk 

PERM 

Sets  a  SYSOUT  group  to  permanent  status,  or  removes 
that  status 

PRINT 

Prints  a  SYSOUT 

Batch  Processing  9-1 


SARBCH  GSS  Interface 


SARBCH  GSS  Interface 

CA-View  interfaces  to  Computer  Associates  CA-GSS  (Global  Subsystem) 
products.  This  interface  allows  you  to  code  REXX  routines  to  have  other  CA-GSS 
products  invoke  SARBCH. 

Possible  uses  of  the  CA-GSS  interface  for  CA-View  are: 

■  Each  time  a  new  user  is  defined  to  the  system,  s/he  is  automatically  defined 
to  the  CA-View  database. 

■  Each  time  a  user  is  deleted  from  the  system,  he  or  she  is  automatically 
deleted  from  the  CA-View  database. 


Installation 

GSS  must  be  installed  at  your  site.  Information  about  installing  CA-GSS  and  the 
GREXX  commands  is  contained  in  the  CA-GSS  documentation. 


For  information  about  installing  CA-View  into  the  CA-GSS,  see  the  "Online 
Interface"  chapter  of  the  CA-View  Installation  Guide. 


CA-GSS/REXX  Interface 

SARBCH  includes  the  CA-View  host  command  enviromnent  to  CA-GSS.  This 
host  cotrunand  environment  is  accessed  by  the  ADDRESS  CA-View  GREXX 
instruction. 

The  commands  processed  by  the  GA-View  host  command  environment  are  the 
same  as  those  that  can  be  specified  on  the  SYSIN  control  cards  that  are  processed 
by  SARBCH. 

The  report  listing  and  messages  issued  by  the  command  environment  are  queued 
for  processing  by  the  GREXX  exec.  The  messages  issued  are  the  same  messages 
that  are  issued  by  SARBCH.  The  report  listings  produced  are  the  same  as  the 
report  listings  produced  by  SARBCH,  except  that  report  headings  and  page 
breaks  are  not  printed  or  placed  on  the  queue. 
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The  following  GREXX  variables  are  used: 


Variable 

Description 

XPVffiW-DBASE 

Specifies  the  CA-View  database  prefix  that  would  normally  be 
specified  on  the  /DBASE  ]SIAME=xxxxxx  control  card 

This  variable  must  be  specified  before  any  XPVIEW 
commands  are  issued.  As  with  SARBCH,  this  length  of  this 
prefix  must  be  less  than  or  equal  to  seventeen: 

RG 

A  variable  that  is  set  by  the  XPVIEW  host  command 
environment  upon  completion  of  the  requested  command 

This  variable  contains  the  return  code  from  the  requested 
command  as  follows: 

Return  Code 

Description 

-3 

Command  not  found 

-2 

Not  enough  memory  to  perform  command 

-1 

Unable  to  access  shared  variable  pool 

0 

OK 

4 

Warning  message  issued;  message  text  on 
stack 

8 

Error  message  issued;  message  text  on  stack 

9 

XPVlEW.DBASEnot  set 

10 

XPVIEW.DBASE  string  too  long 

12 

Severe  error  message  issued;  message  text  on 
stack 

16 

Fatal  error  message  issued;  message  text  on 
stack 

28 

Language  processor  environment  could  not  be 
found 

Probable  CA-GSS  installation  problem. 

32 

Internal  error 

other 

Internal  error 
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Example 


The  following  is  a  sample  REXX  exec  that  demonstrates  the  use  of  the  CA-View 
host  command  environment.  This  sample  is  supplied  on  the  distribution  tape,  in 
file  CALGAIGLIBi 


/* 

/* 


REXX 


Sample  XPVZEW/XSERVE  GREXX  exec 

This  exec  will  look  at  the  users  in  the  CA-View 
database  wd  change  the  banner  to  PRODBAN  for  those  users 
whose  banner  is  currently  set  to  TESTBAN. 

*/ 

Address  XPVZEW 

/* - + - 1 - 5  —  */ 

XPView.  DBase  =  'VIEW.STSTEHl' 

'/list  user=*' 

If  RC  <>  0  Then  Do 

Say  'List  users  failed,  RC= 

Exit  1 

End 

Else  Do 

NumRecs  =  Queued(): 

UserData .0=0 
Do  i  =  1  to  NumRecs 
Parse  Pull  Record 
If  SubStr (Record,  2,5)  <> 


/*Set  the  host  command  env  */ 
/*Must  be  <=  17  characters  */ 
/*Set  the  XPVIEW  database  */ 
/*LiSt  the  users  in  dbase  */ 

/*Was  there  an  error?  */ 

RC  /*Print  an  error  message  */ 

/*Exit  with  an  error  */ 


/^Process  the  user  records  */ 
/*  Get  the  number  of  records*/ 
/*  Initialize  the  User  list  */ 
/*  Pull  each  record  */ 

/*  off  of  the  queue  */ 

SARBC'  Then  Do  /*  Skip  messages 


*/ 


UserData . i . Userid 
UserData . i . Password 
UserData . i .Master 
UserData . i .Mask 
UserData . i .Distid 
UserData . i .Acc 
UserData . i .Mode 
UserData . i .Banner 
UserData . i . Language 
UserData. 0  =  UserData. 0  +  1 
End 


SubStr (Records  2,8) 
SubStr (Records  12 , 8 ) 
SubStr  (Record,  22 , 1); 
SubStr (Record,  25,8V 
SubStr (Record, 35,8) 
S\ibStr  (Record,  45,5) 
SubStr (Record, 52,4) 
SubStr (Record, 58,8) 
SubStr (Record, 70, 1) 


End 

/* 

We  now  have  the  UserData  records  parsed  out. 

Process  them  here. 

*/ 

Do  i  =  1  to  UserData. 0 

If  UserData.!. Banner  =  'TESTBAN  '  Then  Do 

'/defuser  user=' | |Userdata.i.UserXd| | '  Banner=PRODBAN 
Num  =  Queued  (.) 

Do  Num 

Parse  Pull  Message 
Say  Message 

End 

End 

End 


End 
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SARBCH  JCL  Statements 


The  following  job  control  statements  are  required  to  execute  SARBCH: 


JCL  Statementi 

Description 

JOB 

Initiates  the  job 

EXEC 

Specifies  the  program  name  (PGM=SARBCH)  and, 
optionally,  the  high-level  name  of  the  CA-View  database  as 
the  PARM  parameter  (PARM='V1EW.SYSTEM1') 

STEPLIB  DD 

Defines  the  load  library  contaming  SARBCH 

Ifi  the  program  resides  in  a  link  list  library,  omit  this 
statement 

SYSPRINTDD 

Defines  the  sequential  output  data  set  (normally  SYSOUT) 
used  for  listing  the  control  statements  and  messages 

If  this  is  not  a  SYSOUT  data  set,  you  must  code 
DCB=BLKSIZE=nnn,  where  nnn  is  a  multiple  of  121. 

REPORT  DD 

Defines  an  output  data  set  (normally  SYSOUT)  into  which 
SYSOUT  listing  from  the  LIST  function  is  written 

This  statement  can  be  omitted  if  no  LIST  control  statements 
are  input  to  the  program.  If  this  is  not  a  SYSOUT  data  set, 
you  must  code  DCB=BLKSIZE=?mn,  where  nnn  is  a  multiple 
of  121. 

SARLOADDD 

Defines  a  user-maiatained,  sequential  data  set  into  which 
the  LOAD  function  is  to  load  the  SYSOUT 

This  statement  is  optional.  If  omitted,  CA-View  temporarily 
loads  the  SYSOUT  to  the  CA-View  database.  Multiple 
SARLOAD  DD  statements  with  the  FREE=CLOSE 
parameter  can  be  used  to  load  multiple  SYSOUT  groups  to 
different  user-defined  data  sets. 

SYSIN  DD 

Defines  a  card  image  data  set  containing  the  control 
statements  to  be  input 

DDNAME  DD 

Defines  a  data  set  to  which  a  SYSOUT  group  can  be  written  . 

See  the  LOAD  and  PRINT  SARBCH  control  statements. 
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SARBCH 


BPRINT 


Syntax 


Control  Statements 

Control  statements  have  the  following  general  structure: 

/  fvnation  parameters 

m  The  slash  is  coded  in  colmnn  1  and  is  immediately  followed  by  the  name  of 
the  function  to  be  performed. 

■  One  or  more  blanks  must  follow  the  function  name  and  separate  the  function 
name  from  the  parameters. 

■  Individual  parameters  are  separated  by  one  or  more  blanks  and/ or  commas. 

■  A  statement  that  exceeds  71  characters  must  be  continued  on  additional 
cards.  When  continuing  a  statement,  interrupt  the  statement  only  between 
complete  parameters  or  subparameters. 

■  Quoted  parameters  that  flow  onto  additional  cards  can  be  continued  in 
column  2  of  subsequent  cards. 

■  Comments  can  be  included  within  the  control  statements  by  coding  an 
asterisk  in  colixmn  1  of  the  card  image  containing  the  comment. 

The  following  sections  explain  each  of  the  SARBCH  control  statements  in  detail. 


The  BPRINT  control  statement  reprints  a  CA-Deliver  bundle  which  has  been 
archived  to  the  CA-View  database. 

/BPRINT  BANNERS  {bimdle-beumerr  dist-banner,  report -banner) 

BCONT=  {dist-idr  ( (report -id, gen, seg) 

BDXST=dfist-id 

BTD=bundle-id 

FASSWORDsxxzexxxxx 

where: 

Specifies  the  model  banner  page  names  of  the  bundle, 
distribution,  and  report  banner  pages 

The  model  banner  page  name  can  be  omitted.  If  omitted, 
the  model  banner  page  name  defined  to  the  bimdlfe  in  the 
CA-Deliver  database  is  used.  An  asterisk  suppresses  the 
printing  of  the  model  banner  page. 

This  parameter  is  optional. 


BANNERS 

{bundle-banner, 

dist-banner, 

report-banner) 
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BCONT=(dist-i£i>  Specifies  the  distribution  identifiers  and  archived  reports 
((report-id, gen, seq),  that  comprise  the  bimdle 

The  bundle  print  will  be  produced  in  the  exact  sequence  as 
specified  in  this  parameter.  One  or  more  distribution 
identifiers  can  be  specified,  each  followed  by  a  complete 
list  of  report  identifiers,  generation  number,  and  sequence 
number.  The  generation  number  and  sequence  number  can 
be  specified  as  an  absolute  or  a  relative  number. 

If  omitted,  the  most  recently  archived  report  will  be  used. 

This  parameter  is  required. 

BMST=j:  Specifies  the  distribution  identifier  from  which  the 

distribution  barmer-page  instructions  are  to  be  taken 

If  omitted,  the  bundle  distribution  identifier  defined  to  the 
bundle  in  the  CA-Deliver  database  will  be  used;  If  the 
bimdle  distribution  identifier  in  the  CA-Deliver  database 
is  omitted,  the  first  identifier  defined  in  the  BCONT 
parameter  will  be  used. 

'&W=bundle-id  Specifies  the  name  of  the  bimdle  to  be  printed 

This  parameter  is  required. 

PASSWORD=  Specifies  the  same  password  as  the  one  specified  with  the 

xxxxxxxx  PWBATCH  initialization  parameter 

If  specified,  and  the  password  matches  the  one  specified 
with  the  PWBATCH  initialization  parameter,  no  further 
security  checking  is  done,  and  the  requested  SYSOUT 
group  is  printed. 

If  omitted,  or  the  password  does  not  match  the  one 
specified  with  the  PWBATCH  initialization  parameter,  the 
security  user  exit  is  invoked  to  determine  whether  the 
user  is  authorized  to  print  the  SYSOUT  group. 


CHANGE 


The  CHANGE  control  statement  changes  various  attributes  of  a  SYSOUT  group 
that  has  already  been  archived  to  the  CA-View  database. 

You  can  use  this  statement  if  a  SYSOUT  was  archived  with  inappropriate  print 
attributes,  or  if  the  tape  it  was  backed  up  to  has  been  destroyed,  and  its  internal 
status  must  be  changed  to  NOT  BACKED  UP. 
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Syntax 


You  can  modify  the  following  attributes  with  SARBCH  CHANGE: 

■  All  PRINT  attributes 

■  BACKUP 

Specifies  whether  the  SYSOUT  has  been  backed  up  to  tape  from  disk. 

■  USERDATA 

Contains  a  20-byte  user  data  field,  typically  accounting  data. 

■  USERFLD 

Contains  any  user  comments  to  be  displayed  with  the  SYSOUT  in  the 
CA-View  selection  lists. 


/CHANGE  BAGIC[TP=OFF 
BT}IlST=x 

CBAUSs  (xxxx  3aacx  xxxx  laaoc) 

CLASS=x 

COPIES=nmi 

GOPy6=(iUlS  nnn  nnn  nnn  nnn  nnn  rtnn  nnn) 

VEST=3aaaaexxx 
FCB=jaexx 
FLASH=(jaacx  ana) 

FOBH=JCX>ac 

FOSHDEF=XXX3aQCXX 

GEN=aaa 

lD=xx}acxxxxx3cxx 
liXHECT-aaaa 
MODIFy=(»Deic  a) 

OPTCDJ=y I N 

PAGEDEF=xxxX7Da!CX 

PASSWOKDsxxxxxxxx 

PBHODE=XXX3eX3DQC 

PRTY=jaaaaaacx 

SEQ=ana 

UCSsjEIOEX 

USERnATA=a 

USERFLD=a 


where: 

BACKUP=OFF  Specifies  that  the  backup  indicator  for  the  SYSOUT  is  to  be 
turned  off 

The  indicator  is  turned  on  when  a  SYSOUT  is  backed  up.  If  a 
SYSOUT  has  been  backed  up  to  tape,  and  that  tape  is  lost  or 
destroyed,  you  must  specify  BACKUP=OFF,  so  the  CA-View 
backup  cycle  will  backup  the  SYSOUT  again. 

BURST=x  Specifies  a  burst  value  for  the  3800  printer  for  the  SYSOUT 

Valid  values  are  Y  or  N. 
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CHARS=(;xa:3::c 

xxxxxxxxxxx^ 


QLhS&=x 


GOPIES^nnn 


COPYG=(nnM  nnn 
nnn  nnn  nnn  nnn 
nnn  nnn) 


FCB  =xxxx 


FLASH=(xx;cx 

nnn) 


FORM=a::x:a:a: 

FORMDEF=3:a:x;c3: 

XXX 


GEN=nnn 


1D=XXXXXXXXXXXX 


Specifies  a  set  of  character  arrangement  table  names  for  the 
3800  printer  for  the  SYSOUT 

You  can  specify  a  value  of  1  to  4  names  separated  by  one  or 
more  blanks  and/ or  commas  and  enclosed  in  parentheses. 

Specifies  a  class  for  the  SYSOUT 

Specifies  a  number  of  copies  to  override  the  one  used  to  print 
the  SYSOUT 

A  range  of  1  to  255  can  be  specified. 

Specifies  an  optional  set  of  copy  groups  for  the  3800  printer  to 
override  those  used  to  print  the  SYSOUT 

You  can  specify  a  range  of  1  to  8  copy  groups  separated  by 
one  or  more  blanks  and/or  commas  and  enclosed  m 
parentheses.  Each  copy  group  value  must  be  in  the  range  of  1 
to  255. 

Specifies  an  optional  destination  to  override  the  one  used  to 
print  the  SYSOUT 

The  destination  can  be  a  synon5Tn  created  via  the  online 
DEFine  DEVice  command. 

Specifies  an  optional  forms  control  image  to  override  the  one 
used  to  print  the  SYSOUT 

Specifies  an  optional  forms  flash  overlay  name  and  flash  count 
for  the  3800  printer  to  override  those  used  to  print  the  SYSOUT 

The  forms  flash  overlay  name  and  copy  count  are  separated 
by  one  or  more  blanks  and/ or  commas  and  are  enclosed  in 
parentheses. 

Specifies  an  optional  forms  name  to  override  the  one  used  to 
print  the  SYSOUT 

Specifies  a  library  member  containing  statements  to  control 
printing  of  the  SYSOUT  data  on  the  3800  printer 

The  statements  can  specify  overlay  forms,  page  location  for 
overlays,  and  page  format  suppressions  that  can  be  activated. 

Specifies  the  absolute  or  relative  number  of  the  generation  for 
which  SYSOUT  is  affected  by  the  CHANGE  statement 

If  omitted,  the  most  recently  archived  SYSOUT  group  for  the 
ID  is  affected. 

Specifies  the  SYSOUT  ID  of  the  group  to  be  affected  by  the 
CHANGE  statement 

This  parameter  is  required. 
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LTNECT=nnnn 
MOMFY=(j:a:a:;c  n) 


OPTCDJ=Y  I N 

PAGEDEF= 

xxxxxxxx 

PASSWORD= 

xxxxxxxx 


PKMODE= 

xxxxxxxx 

SEQ=nnn 


UCS=xxxx 

USERDATA=arxx3: 

USEKFLD=xxj:;c 


Specifies  the  maximum  number  of  lines  to  be  printed  on  each 
output  page 

Specifies  an  optional  copy  modification  module  name  and 
table  reference  character  for  the  3800  printer  to  override  those 
used  to  print  the  SYSOTJT 

The  copy  modification  module  name  and  table  reference 
character  are  separated  by  one  or  more  blanks  and/or 
commas  and  are  enclosed  in  parentheses.  The  table  reference 
character  can  have  a  range  of  0  to  3. 

Specifies  an  optional  override  as  to  whether  the  SYSOUT 
records  contain  table  reference  characters  for  the  3800  printer 

Valid  values  are  Y  or  N. 

Specifies  a  library  member  containing  statements  to  control 
printing  of  the  SYSOUT  data  on  the  3800  printer 

The  statements  can  specify  logical  page  length,  width,  fonts, 
and  page  segments. 

Specifies  the  same  password  as  the  one  specified  with  the 
PWBATCH  initialization  parameter 

If  specified,  and  the  password  matches  the  one  specifies  with 
the  PWBATCH  initialization  parameter,  no  further  security 
checking  is  done,  and  the  requested  SYSOUT  group  is  printed. 

If  omitted,  or  the  password  does  not  match  the  one  specified 
with  the  PWBATCH  initialization  parameter,  the  security  user 
exit  is  invoked  to  determine  whether  the  user  ID  is  authorized 
to  print  the  SYSOUT  group. 

Specifies  the  process  mode  required  for  printing  the  SYSOUT 
group 

Specifies  the  absolute  or  relative  SYSOUT  sequence  number  of 
the  SYSOUT  group  to  be  affected  by  the  CHANGE  statement 

If  omitted,  the  most  recently  archived  SYSOUT  group  for  the 
ID  and  generation  specified  is  affected.  This  is  ignored  when 
GEN  is  omitted. 

Specifies  an  optional  special  character  set  name  to  override  the 
one  used  to  print  the  SYSOUT 

Specifies  a  20-byte  user  data  field  (typically  accounting  data) 

Specifies  user  comments  to  be  displayed  with  this  SYSOUT  on 
the  CA-View  selection  lists 

If  you  want  to  include  any  spaces  within  the  comment,  enclose 
the  entire  comment  in  quotes,  as  in  USEREIlD='THIS  IS  MY 
COMMENT'. 
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Defaults  If  you  specify  a  parameter  without  a  value,  that  parameter  will  be  set  to  blanks. 

For  example,  if  you  specify: 

PAGEDEF= 

the  PAGEDEF  field  will  be  set  to  blanks. 


DBASE 

The  DBASE  control  statement  is  used  to  specify  the  high-level  name  of  the 
CA-View  database.  If  omitted,  the  high-level  name  specified  as  the  FARM 
parameter  on  the  EXEG  JGL  statement,  if  any,  is  used.  The  DBASE  control 
statement  applies  to  all  control  statements  that  follow  it  until  another  DBASE 
control  statement  is  encountered. 

Syntax  /DBASE  lIAHE=jaaExxxxxxxxxxx3£xx 

where  xxxxxxxxxxxxxxxxspeafies  the  high-level  name  for  the  GA-View  database. 


DEFDIST 


Syntax 


The  DEFDIST  control  statement  creates  or  modifies  a  list  of  SYSOUT  IDs  for  a 
DIST  ID. 

/DEFDIST  DISTID=XXXXCCXX 

SYSOUT=j£xx}aaa£xxxxx 

SySDESC=X70£X3a£XXXXXX2EXXX 
DXDDESC=xxxxxxx3aaaac3aac 
RVIEW=Y  N 
REPRT=Y  N 

del=y|n 

where; 


DISTID^xcxxxxxc  Specifies  the  name  of  the  distribution  identifier  to  be 
processed 

This  value  can  be  1  to  8  characters  with  national  and/ or 
alpha-numeric  characters. 


SYSOUT=  Specifies  the  name  of  the  SYSOUT  to  be  processed 

xxxxxxxxxxxx  ^  SYSOUT  does  not  exist  in  the  GA-View  database,  it 

will  be  added.  If  it  already  exists,  it  will  be  modified. 


SYSDESG=  Specifies  a  description  of  the  SYSOUT 

XXXXXXXXXXXXXXXX  ™  .  ,  u  1  1.  0.1  1. 

This  value  can  be  1  to  24  characters. 
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DIDDESC= 

xxxxxxxxxxxxxxx 


Specifies  the  description  of  the  DIST  ID 
This  value  can  be  1  to  24  characters. 


RVIEW=Y  I N 
REPRT=YIN 


DEL=Y  I N 


Specifies  whether  logical  view  access  for  the  associated 
SYSOUT  is  to  be  restricted  to  non-secured  logical  views 

Specifies  reprint  capability;  indicates  whether  the  user  can 
reprint  SYSOUT 

Specifies  the  delete  capability;  indicates  whether  the  DIST 
ID  can  delete  SYSOUT 


DEFSYS 


Syntax 


The  DEFSYS  control  statemait  creates  or  modifies  a  list  of  DIST  IDs  for  a 

SYSOUT  ID. 

/DEFSYS  SYSOXJT=3ae3aaaixicx3acx 
DZSTXDsjcxxxxxxx 
SYSDBSC=3cxxxxKX3aaac3C3cx3cx 
DIDUBSC=3aaaex3aaexx3exiaex 
RVIEW=Y  N 
REPRT=Y  N 
DEL=Y I H 

where: 


SYSOUT= 

xxxxxxxxxxxx 


DISTID= 

xxxxxxxx 


Specifies  the  name  of  the  SYSOUT  to  be  processed 

If  the  SYSOUT  does  not  exist  in  the  CA-View  database,  it 
will  be  added.  If'  it  already  exists,  it  will  be  modified. 


Specifies  the  name  of  the  distribution  identifier  to  be 
processed 


This  value  can  be  1  to  8  characters  with  national  and/or 
alpha-numeric  characters. 


SYSDESC= 

xxxxxxxxxxxxxxxx 


Specifies  a  description  of  the  SYSOUT 
This  value  can  be  1  to  24  characters. 


DIDDESC= 

xxxxxxxxxxxxxxx 


Specifies  the  description  of  the  DIST  ID 
This  value  can  be  1  to  24  characters. 


RVIEW=Y  I N 


REPRT=YIN 


DEE=Y  I N 


Specifies  whether  logical  view  access  for  the  associated 
SYSOUT  is  to  be  restricted  to  non-secured  logical  views 

Specifies  reprint  capability;  indicates  whether  the  user  can 
reprint  SYSOUT 

Specifies  the  delete  capability;  indicates  whether  the  DIST  ID 
can  delete  SYSOUT 
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DEFUSER 


Syntax 


The  DEFUSER  control:  statement  adds  CA-View  user  IDs  to  the  database,  or 
modifies  existing  user  IDs. 


/DEFUSER  USER=XXXX}CXXX 

USERPSWD=XS£»£XXX 

H&STER=Y|N 

DZSmA.SK=X»£X3EXXX 

DZ  STZDsxxxsoexx 

ACC=xxxxx 

HODE=xxxx 

BANIIERsjcxxssexxx 

JCL1=XXXX»£XX 
JCI>2  ^XKoaaaaat 
jCIi3  =X3aaaaa{x 
JCIi4  =x3aaaaacx 
IiAN6UA6E=x 
PCIASS=x 
PDEST=x 
ACIASS=x 
ADEST=X 


where; 

USER=  Specifies  the  name  of  the  user  ID  to  be  processed 

xxxxxxxx 

If  the  user  ID  does  not  exist  in  the  database,  it  will  be  added.  If 
it  already  exists,  it  will  be  modified.  This  parameter  is 
required. 

USEKPSWD=  Specifies  the  password  associated  with  the  user  ID  for  logging 
xxxxxxxx  on  to  an  online  session 

This  value  can  be  1  to  8  characters  with  national  and/ or  alpha¬ 
numeric  characters.  This  parameter  is  optional 

MASTER=Y  I N  Specifies  whether  the  USER  has  master  authority 

If  omitted,  MASTER=N  is  used. 

DISTMASK=  Specifies  the  generic  distribution  ID  mask  for  users  in  EXP 
xxxxxxxx  mode  or  SAR  mode 

This  value  can  be  1  to  8  characters  with  any  combination  of 
asterisk,  national  and  alpha-numeric  characters. 

If  omitted,  MASK=Msen'£i  is  used. 

DISTID=  Specifies  the  default  DIST  ID  for  users  in  EXP  mode  or  SAR 

xxxxxxxx  mode 

This  value  can  be  1  to  8  characters  with  alpha-numeric  and/or 
national  characters. 

If  omitted,  UlSTnD=userid  is  used. 
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A£C.=xxxxx 

MODE=j:j:xa: 

BANNER= 

xxxxxxxx 

]G.'Ll=xxxxxxxx 

through 

]C'L4=xxxxxxxx 

LANGUAGE=x 

PCLASS=:r 

PDEST=:»: 

AGLASS=s: 

ADEST=x 


Specifies  which  of  the  modes  a  user  can  access 

This  value  is  A  5-character  string  consisting  of  a  combination  of 
Ys  and  Ns  to  indicate  whether  the  user  can  access  modes  ALL, 
EXPO,  EXP,  SARO  and  SAR  respectively. 

If  omitted,  SARINTT  parameter  DEFMODE  is  used.  At  least  one 
mode  must  be  active,  so  ACC=NNNNN  is  not  valid. 

Specifies  the  default  mode  in  which  the  user  automatically 
enters  CA-View 

If  omitted,  the  first  D  in  the  ACC  parameter  will  be  used.  If 
there  is  no  D,  the  first  Y  will  be  used.  If  ACC  is  omitted,  the 
SARINIT  parameter  DEFMODE  is  used;  otherwise  ALL  willbe 
used. 

Specifies  the  default  BAISINER  page  for  user  in  EXP  mode 

This  value  can  be  1  to  8  characters  with  alpha-numeric  or 
national  characters. 

This  parameter  is  optional. 

The  JCL  job  submit  cards  used  by  CA-View  J  selection  code 
printing 

JCL  statements  that  contain  blank  or  special  characters  must  be 
enclosed  in  single  or  double  quotes.  An  example  is: 

JGLl="//AJOB  JOB  MSGCLASS=*" 

Specifies  the  system  default  language  to  be  used  when 
displaying  online  panels  and  messages 

Possible  values  are  R  (or  blank)  for  English;  C  for  Canadian 
French,  G  for  German,  D  for  Danish. 

Specifies  the  Primary  CLASS  to  be  used  in  the  Print  menu  for  a 
user  in  SAR  or  EXP  mode 

Specifies  the  Primary  DEST  to  be  used  in  the  Print  menu  for  a 
user  in  SAR  or  EXP  mode 

Specifies  the  Alternate  CLASS  to  be  used  in  the  Print  menu  for 
a  user  in  SAR  or  EXP  mode 

Specifies  the  Alternate  DEST  to  be  used  in  the  Print  menu  for  a 
user  in  SAR  or  EXP  mode 
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DELETE 


The  DELETE  control  statement  deletes  the  following  from  the  database: 

■  An  archived  SYSOLT' 

■  The  page  indexes  of  a  SYSOUT 

■  A  user  ID 

■  A  logical  view 

SyntOX  /DELETE  ID=3cxxxxxx3aaaac 

DISK 

aEMgnnnnn 

PXSSW0KD=x3e3ex3aacx 

SEQ=nnniin 

USER=JOoexxxTEX 

VIEWsnoii 

INDEX 

where; 

ID=  Specifies  the  SYSOUT  identifier  on  the  SYSOUT  group  or  view 

xxxxxxxxxxxx  that  is  to  be  deleted 

If  this  parameter  is  specified  by  itself  or  with  the  GEN  and/or 
SEQ  parameters,  the  respective  archival  SYSOUT  group  is 
permanently  deleted  from  the  database. 

If  this  parameter  is  specified  with  the  VIEW  parameter,  only  the 
respective  view  control  records  are  deleted.  The  ID  parameter 
cannot  be  specified  with  the  USER  parameter. 

Specifies  that  the  disk  space  occupied  by  the  SYSOUT  group  is  to 
be  deleted  from  the  database 

The  index  reference  SYSOUT  group  is  not  deleted.  The  DISK 
parameter  cannot  be  specified  with  the  VIEW  and  USER 
parameters. 

GEN=nnnnn  Specifies  the  absolute  or  relative  niimber  of  the  generation  of  the 

SYSOUT  group  to  be  deleted 

If  omitted,  the  most  recently-archived  SYSOUT  group  for  the  ID 
is  used-  This  parameter  cannot  be  specified  with  the  CA-View 
and  USER  parameters. 


DISK 
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PASSWORD= 

xxxxxxxx 


SEQ=nnnnn 

USER= 

xxxxxxxx 

VIEW=nnn 

INDEX 


Specifies  the  same  password  as  the  one  specified  with  the 
PWBATCH  initialisation  parameter 

If  specified,  and  the  password  matches  the  one  specified  by  the 
PWBATCH  initialization  parameter,  no  further  security  checking 
is  done,  and  the  requested  SYSOUT  group  is  deleted. 

If  omitted,  or  the  password  does  not  match  the  one  specified  with 
the  PWBATCH  initialization  parameter,  the  security  user  exit  is 
invoked  to  determine  whether  the  user  is  authorized  to  delete  the 
SYSOUT  group. 

Note:  Password  checking  is  not  done  for  the  DELETE  USER 
command,  but  is  done  for  the  DELETE  VIEW  and  the  DELETE  ID 
commands. 

Specifies  the  absolute  or  relative  sequence  number  of  the 
SYSOUT  group  to  be  deleted 

If  omitted,  the  most  recently  archived  group  for  the  ID  and 
generation  specified  is  deleted.  This  parameter  is  ignored  when 
the  GEN  parameter  is  omitted  and  cannot  be  specified  with  the 
VIEW  and  USER  parameters. 

Specifies  the  name  of  the  USERID  to  be  deleted  from  the  database 

This  parameter  cannot  be  specified  with  the  GEN  and  SEQ 
parameters. 

Specifies  a  number  from  1  to  255  of  the  logical  view  to  be  deleted 

Specify  an  asterisk  to  delete  all  logical  views  for  the  specified 
SYSOUT  group. 

This  parameter  cannot  be  specified  with  the  GEN  and  SEQ 
parameters. 

Deletes  any  created  page  indexes  for  the  report  on  the  disk 
database 

Page  indexes  on  disk  are  used  by  the  CA-View  online  cross  report 
indexing  capability.  (The  page  index  definitions  still  exist  with  the 
logical  views  for  the  report.) 
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EPRINT 


The  CA-Deliver-to-CA-View  mte3rface  provides  a  function,  invoked  by  the 
EPRINT  control  statement,  to  print  reports  archived  directly  from  GA-Deliver. 

Syntax  /EPRINT  BM!IISlE^=3aaaaacxx 

BURST=x 

CH2ms=  (X3aae  xiexx  jocxx  sacxx) 

CLASS=X 

GOPXES=x 

COPy6= (ium  nnn  nnn  nnn  nnn  non  nnn  nnn) 

D1ST=  ( Cdistia  distid  „J/dast  (distid  distid  ...)  /dest  ...) 

FGB=JCXXX 

FIASH=(xxx»:  zmn) 

FOSM=jcxkx 

F0'BlSDEF=x3aaexx 

GBSI=nxm 

HOIkD=y|tl 

TD=xxxxicx3aaacxx 

ZESTS (  ' text '  'text ’ . . .) 

MODlFy= {xxxx  n) 

OPTGDJ=y|H 

OUTPUTsnajne 

PA6E=(iizui  zum  nnn  nnn  nnn  nnn  nnn  nnn  nnn), 

PA6EDEF=xxx7exx 

PASSWOSDsxxxxxxxx 

PRHODEsXXXXWfXX 

REGORDsCnnn  nnn  nnn  nnn  nnn  nnn  nnn  nnn  nnn) 
SELEGTsxxxxxxxx 

V  y  SEQsnnn 

UGSsxxxx 

ViEWsnnn 

WRZTERsn 


where: 


BANNER=  Specifies  an  optional  model  baimer  page  name  to  be  used  to 
xxxxxxxx  override  the  one  defined  for  the  report  in  the  CA-Deliver 

database. 

BURST=Y  I N  Specify  Y  or  N  to  indicate  whether  the  report  destined  for  the 
3800  needs  to  be  burst. 


CHARS=(xzrx  Specifies  an  optional  set  of  character  arrangement  table  names  for 
xxxx  xxxx  xxxx)  the  3800  printer  to  override  the  ones  used  to  print  the  report 

A  value  of  1  to  4  names  separated  by  one  or  more  blanks  and/or. 
commas  and  enclosed  in  parentheses  can  be  specified. 

CLASS=r  Specifies  an  optional  class  to  override  the  one  used  to  print  the 
report 


COPIES=Y  1 N  Specify  Y  or  N  to  indicate  whether  the  copies  value  is  to  be  used 
when  printing  the  report  for  the  report  recipients. 
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COPYG=(nnw 
nnn  nnn  nnn 
nnn  nnn  nnn 
nnn) 


DlST={{distid 

distid)/dest 

{distid 

distid/dest) 


FLASH= 
{xxxx  nnn) 


FORM=a:3:xa: 

FORMDEF= 

xxxx 


GEN=nnn 


HOED=YIN 


Specifies  an  optional  set  of  copy  groups  for  the  3800  printer  to 
override  the  ones  used  to  print  the  report 

A  value  of  1  to  8  copy  groups  separated  by  one  or  more  blanks 
and/or  commas  and  enclosed  in  parentheses  can  be  specified. 
Each  copy  group  value  must  be  in  the  range  of  1  to  255. 

Specifies  an  optional,  complete  definition  of  distribution 
specifications  to  override  the  one  defined  for  the  report  m  the 
CA-Deliver  database 

Specify  a  list  of  distribution  identifiers  or  groups  of  distribution 
identifiers  separated  by  one  or  more  blanks  and/ or  commas  and 
enclosed  in  parentheses.  A  group  of  distribution  identifiers 
consists  of  a  list  of  distribution  identifiers  separated  by  one  or 
more  blanks  and/ or  commas  and  enclosed  in  parentheses. 

Only  one  copy  of  the  report  is  written  to  spool  for  a  group;  the 
model  banner  page  for  the  group  then  references  all  the 
distribution;  identifiers  m  the  group.  An  optional  remote  prmt 
destination  can  be  specified  for  any  single,  non-grouped 
distribution  identifier  or  any  group  of  distribution  identifiers  by 
following  the  distribution  identifier  or  group  with  a  slash  (/)  and 
the  destination;  The  destination  can  be  a  s5monym  created  via  the 
online  DEFine  DEVice  command. 

Specifies  an  optional  forms  control  image  to  override  the  one 
used  to  print  the  report 

Specifies  an  optional  forms  flash  overlay  name  and  flash  cotmt  for 
the  3800  printer  to  override  those  used  to  print  the  report 

The  forms  flash  overlay  name  and  flash  count  are  separated  by 
one  or  more  blanks  and/or  commas  and  are  enclosed  m 
parentheses. 

Specifies  an  optional  forms  name  to  override  the  one  used  to  print 
the  report 

Specifies  a  library  member  containing  statements  to  control 
printing  of  the  SYSOUT  data  on  the  3800  printer 

The  statements  can  specify  overlay  forms,  page  location  for 
overlays,  and  page  format  suppressions  that  can  be  activated. 

Specifies  the  absolute  or  relative  number  of  the  generation  of  the 
report  to  be  printed 

If  omitted,  the  most  recently-archived  report  for  the  report 
identifier  is  printed. 

Specifies  whether  the  report  is  to  be  placed  on  the  held  queue  for 
printing 

If  omitted,  HOED=N  is  assumed. 
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ID= 

xxxxxxxxxxxx 


INST= 

{^texf  'text' ) 


MODIFY= 
(xxxx  n) 


OPTCDJ=YIN 

OUTPUT= 

xxxxxxxx 


PAGE=(nnn 
nnn  nnn  nnn 
nnn  nnn  nnn 
nnn  nnn) 


Specifies  the  SYSOUT  ID/report  identifier  of  the  group  to  be 
printed 

This  parameter  is  required. 

Specifies  an  optional,  complete  set  of  special  instructions  to 
override  the  set  defined  for  the  report  in  the  CA-Deliver  database 

Multiple  lines  of  instruction  text  can  be  specified  as  a  list  of  the 
text  lines  separated  by  blanks  and  /  or  commas  and  enclosed  in 
parentheses. 

A  single  line  of  text  must  be  enclosed  within  single  quotation 
marks;  a  single  quotation  mark  within  the  text  itself  must  be 
represented  by  two,  contiguous  single  quotation  marks. 

Specifies  an  optional  copy  modification  module  name  and  table 
reference  character  for  llie  3800  printer  to  override  those  used  to 
print  the  report 

The  copy  modification  module  name  and  table  reference 
character  are  separated  by  one  or  more  blanks  and/ or  commas 
and  are  enclosed  in  parentheses. 

The  table  reference  character  can  have  a  value  of  0  to  3. 

Specify  Y  or  N  to  indicate  whether  the  report  records  contain 
table  reference  characters  for  the  3800  printer 

Specifies  the  name  of  the  output  statement  to  be  used  for  printing 
the  SYSOUT  group 

This  parameter  overrides  the  specifications  of  the  FORMDEF, 
LINECNT,  PAGEDEF,  FRMODE,  and  possibly,  FORM 
parameters.  The  parameter  {xxxxxxxx)  data  is  specified  as 
follows: 

name 

stepaame.aame 

atepname.procstepname  .name 

An  asterisk  can  precede  the  parameter  data  to  match  the  JCL 
specification  of  the  OUTPUT  parameter. 

Specifies  1  to  9  page  numbers  and/or  ranges  of  pages  to  be 
printed 

The  page  numbers  and/or  ranges  of  pages  are  separated  by  one 
or  more  blanks  and/or  commas  and  are  enclosed  in  parentheses. 
A  range  of  pages  is  specified  as  two  page  ntimbers  separated  by 
a  colon 

If  both  PAGE  and  RECORD  are  omitted,  the  entire  SYSOUT 
group  is  printed. 
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PAGEDEF= 

xxxx 


PASSWORD= 

xxxxxxxx 


PRMODE= 

xxxxxxxx 

RECORD=(nnn 
nnn  nnn  nnn 
nnn  nnn  nnn 
nnn  nnn) 


SELECT= 

xxxxxxxx 


SEQ=nnn 


\JCS=xxxx 


VIEW=finn 


WRITER= 

xxxxxxxx 


Specifies  a  library  member  containing  statements  to  control 
printing  of  the  SYSOUT  data  on  the  3800  printer 

The  statements  can  specify  logical  page  length;  width;  fonts,  and 
page  segments. 

Specifies  the  same  password  as  the  one  specified  with  the 
PWBATCH  option 

If  specified  and  the  password  matches  the  one  specified  with  the 
PWBATCH  option,  no  further  security  checking  is  done,  and  the 
requested  SYSOUT  group  is  printed. 

If  omitted  or  the  password  does  not  match  the  one  specified  with 
the  PWBATCH  initialization  parameter,  the  security  user  exit  is 
invoked  to  determine  whether  the  user  is  authorized  to  print  the 
SYSOUT  group. 

Specifies  the  process  mode  required  for  printing  the  SYSOUT 
group 

Specifies  1  to  9  record  numbers  and/or  ranges  of  records  to  be 
printed 

The  record  numbers  and/or  ranges  of  records  are  separated  by 
one  or  more  blanks  and/or  commas  and  are  enclosed  in 
parentheses.  A  range  of  records  is  specified  as  two  record 
numbers  separated  by  a  colon. 

If  botti  PAGE  and  RECORD  are  omitted,  the  entire  SYSOUT 
group  is  printed. 

Specifies  the  page  separation  index  value  for  selecting  pages  to 
print 

If  the  value  contains  any  of  the  special  characters:  blank,  comma, 
or  single  quote,  the  index  value  must  be  enclosed  within  single 
or  double  quotes. 

Specifies  the  absolute  or  relative  SYSOUT  sequence  number  of 
the  report  to  be  printed 

If  omitted,  the  most  recently-archived  report  of  the  identifier  and 
generation  specified  is  printed.  This  operand  is  ignored  when 
GEN  is  omitted. 

Specifies  an  optional;  special  character  set  name  to  override  the 
one  used  to  print  the  report 

Specifies  a  view  format  in  which  report  is  printed^  where  n  =  1  to 
255 

Specifies  the  external  writer  name  to  be  used  for  printing  the 
SYSOUT  group 
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EXTRACT 


Syntax 


The  EXTRACT  control  statement  specifies  that  a  SYSOUT  archived  to  CA-View  is 
to  have  fields  extracted  from  it  by  CA-Balancing. 

/EXTRACT  GEN=mm 

XD^iaesaaaaexiaaae 

I!ISBSSN=3exxxx}C3cx3ac3aaaexx3aaaacxx 

PAGE=(iiim  nan  nnn  nnn  nnn  nnn  nnn  nnn  nnn) 

PASSWORD=xxxxxxxx 

SEQsxuixi 

where: 


GEN=n«M  Specifies  the  absolute  or  relative  nrnnber  of  the  generation  of 

the  report  to  be  accessed  by  CA-Balancing 

If  omitted,  the  most  recently-archived  report  for  the  report 
identifier  is  used. 


ID= 

xxxxxxxxxxxx 


Specifies  the  SYSOUT  ID /report  identifier  of  the  group 
This  parameter  is  required. 


INBSSN=  Specifies  the  CA-Balancing  LSERV  subsystem  name 

{'text'  'text' ) 

PAGE=(nnn  nnn  Specifies  1  to  9  page  numbers  and/or  ranges  of  pages  where 
nnn  nnn  nnn  nnn  data  fields  will  be  extracted  by  CA-Balancing 
nnn  nnn  nnn) 


PASSWORD^  Specifies  the  same  password  as  the  one  specified  with  the 
xxxxxxxx  PWBATCH  option 

If  specified  and  the  password  matches  the  one  specified  with 
the  PWBATCH  option,  no  further  security  checking  is  done. 

SEQ=nnn  Specifies  the  absolute  or  relative  sequence  number  of  the 

SYSOUT  group  to  be  accessed  by  CA-Balancing 

If  omitted,  the  most  recently-archived  group  for  the  ID  and 
GEN  specified  is  used.  This  operand  is  ignored  when  GEN  is 
omitted; 
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INDEX 


Syntax 


The  INDEX  control  statement  creates  a  page  index  for  a  SYSOUTs,  using  all  page 
separation  criteria  defined  online.  Page  separation  criteria  are  defined  with  the 
logical  views  of  a  SYSOUT.  See  the  chapter  on  Logical  Viewing  in  the  CA-Viezv 
Online  User's  Guide  for  more  information  about  page  indexing. 

An  archived  report  must  reside  on  the  GA-View  primary  disk  database  to  be 
indexed. 


/IHDEX  6EIl=ztmi 

XD=3ae3aaaex3ac3cxx 

PASSWORDsjcxxxxxxx 

SEQsjum 

where; 


GEN=nnM  Specifies  the  absolute  or  relative  number  of  the  generation  of 

the  report  to  be  indexed 

If  omitted,  the  most  recently-archived  report  for  the  report 
identifier  is  used. 


IDi=  Specifies  the  SYSOUT  ID/report  identifier  of  the  group 

xxxxxxxxxxxx  , 

This  parameter  is  required. 

PASSWOKD=  Specifies  the  same  password  as  the  one  that  was  specified  with 
xxxxxxxx  the  PWBATCH  option 

If  specified  and  the  password  matches  the  one  specified  with 
the  PWBATCH  option,  no  further  security  checking  is  done. 

SEQ=nnn  Specifies  the  absolute  or  relative  sequence  number  of  the 

SYSOUT  group  to  be  indexed 

If  omitted,  the  most  recently-archived  group  for  the  ID  and 
GEN  specified  is  used.  This  operand  is  ignored  when  GEN  is 
omitted. 
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LIST 


SYSOUT  Listing 


The  LIST  control  statement  produces  a  listing  of  archived  SYSOUT  and  user  IDs. 
The  report  is  output  to  ftie  REPORT  DD  statement. 

The  listing  of  archived  SYSOUT  groups  can  be  for  an  individual  SYSOUT 
group,  a  complete  generation  of  archived  SYSOUT,  or  all  archived  SYSOUT. 

The  listing  contains  the  following  information: 

■  SYSOUT  ID 

■  Job  name 

■  Job  ID 

■  Generation  niimber 

■  SYSOUT  sequence  number 

■  Archive  date  and  time 

■  Last  print  date  and  time 

■  Location  of  the  SYSOUT  (disk,  tape,  or  temporary  disk) 

■  Number  of  lines  archived 

■  Niimber  of  pages  archived 

■  Number  of  3476-byte  blocks  written  to  disk 

■  Exception  condition 


The  following  is  a  SYSOUT  listing  generated  by  the  LIST  control  statement: 


SARBCT 

CA-VIEW  (2,0) 

-  BATCH 

PROCESSING  UTILITY 

PAGE 

1 

01/13/97 

SYSOUT 

ARCHIVAL 

LISTING 

ID 

JOBNAME 

JOBID 

GEN 

SEQ 

ARC  DATE 

ARC  TIME 

PRT  DATE 

PRT  TIME  LOC  LINES 

PAGES 

BLOCKS 

XCODE 

TSEQ 

ASTALLEG 

ASTALLEG 

JOB05544 

26 

7 

12/18/92 

13:42:35 

12/18/96 

15:10:11  DISK  24 

6 

1 

BSPURRIS 

BSPURRIS 

JOB05185 

26 

1477 

01/12/97 

11:55:31 

DISK  93 

4 

1 

BSPURRIl 

BSPURRIl 

JOB05668 

26 

1458 

01/11/97 

15:57:06 

DISK  2166 

54 

27 

BSPURRIl 

BSPURRIl 

JOB05156 

26 

1454 

01/11/97 

13:37:08 

DISK  18708 

587 

432 

0016 

BSPURRIl 

BSPURRIl 

JOB05148 

26 

1453 

01/11/97 

13:00:40 

DISK  186 

5 

3 

S222 

CBRMOBBP 

CBRMOBBP 

JOB05119 

26 

1517 

01/13/97 

19:42:05 

DISK  17149 

319 

217 

CBRMOBOT 

CBRMOBOT 

JOB05312 

26 

1518 

01/13/97 

19:42:11 

DISK  15987 

297 

198 

CNV153 

CNV153 

JOB05276 

26 

1340 

01/04/97 

14:52:32 

DISK,  70 

3 

1 

DCL-RMOBBP 

DLEE2 

JOB05230 

26 

1297 

12/31/96 

11:23:43 

DISK. 12581 

239 

182 

DCL-RMOBBP 

DLEE2 

JOB05105 

26 

1296 

12/31/96 

19:52:15 

DISK  12584 

239 

182 

DCL-RMODBASE 

DLEE2 

JOB05179 

26 

1378 

01/05/97 

13:50:42 

DISK  7463 

148 

103 

dcl-rmogam: 

DLEE2 

JOB05471 

26 

1040 

12/30/96 

13:25:29 

DISK  4009 

82 

56 

DCL-RMOGRDB 

DLEE2 

JOB05859 

26 

1387 

01/05/97 

16:40:48 

DISK  7320 

139 

111 

0004 

DCL-RMOPRDCD 

DLEE2 

JOB05249 

26 

1382 

01/05/97 

14:00:35 

DISK  1988 

40 

28 

DCL-RMOPRDCD 

DLEE9 

JOB05540 

26 

5 

12/18/96 

13:42:30 

DISK  2010 

40 

28 

DCL-RMORPT 

DLEE2 

JOB05494 

26 

61 

12/29/96 

18:34:42 

DISK  2529 

54 

34 

DCL-RMOSTC 

DLEE3 

JOB05782 

26 

34 

12/23/96 

21:24:03 

DISK, 16531 

320 

234 

DCL-RMOUTIL 

DLEE2 

JOB05639 

26 

1057 

12/30/96 

29:17:06 

DISK,  3511 

72 

50 

DCLP1322 

DCLP1322 

JOB05926 

26 

1389 

01/05/97 

13:30:20 

DISK,  143 

6 

2 

DCLP1322 

DCLP1322 

JOB05186 

26 

1388 

01/05/97 

13:30:18 

DISK  143 

6 

2 

DLEE 

DLEE 

TSU05764 

26 

8 

12/18/96 

13:42:35 

DISK  224 

3 

3 
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User  ID  Listing  The  listing  of  user  IDs  can  be  for  an  individual  user  ID;  a  group  of  user  IDs,  or 

all  user  IDs.  The  listing  contains  the  following  information: 

■  User  ID 

■  User  ID  password 

■  Master  capability  indicator 

■  Generation  number 

■  Distribution  identifier  validation  mask 

■  Distribution  identifier 

■  Mode  access  indicator 

■  Current  mode 

■  Default  banner  name 

The  following  is  a  user  ID  listing  generated  by  the  LIST  control  statement: 


SARBCT 

CA 

-VIEW  2.0  - 

BATCH 

PROCESSING  UTILITY 

PAGE 

1 

01/13/97 

USERID 

LISTING 

DISTID 

AEESS 

USERID 

PASSWORD  M 

MASK 

DISTID 

0  0 

MODE 

BANNER 

N 

ACCT 

YYVNN 

ALL 

DEFAULT 

AMAR20 

N 

AMARZO 

AMARZO 

YYYYN 

ALL 

DEFAULT 

CSA 

N 

CSA 

CSA 

YYYYN 

EXPO 

DEFAULT 

CUSTOl 

N 

CUSTOl 

CUSTOl 

YYYYN 

ALL 

DEFAULT 

CUST03 

N 

CUST03 

CUST03 

YYYYN 

ALL 

DEFAULT 

CUST05 

N 

CUST05 

CUSTOS 

YYYYN 

ALL 

DEFAULT 

CUST09 

N 

CUST09 

CUST09 

YYYYN 

ALL 

DEFAULT 

CUSTll 

N 

CUSTll 

CUSTll 

YYYYN 

ALL 

DEFAULT 

ESCHIN 

N 

ESCHIN 

ESCHIN 

YYYYN 

ALL 

DEFAULT 

ESCHI2 

N 

ESCHI2 

ESCHI2 

YYYYN 

ALL 

DEFAULT 

ESCHI3 

N 

ESCHI3 

ESCHI3 

YYYYN 

ALL 

DEFAULT 

HGROUP 

N 

HGROUP 

HGROUP 

YYYYN 

ALL 

DEFAULT 

Syntax  /list  Exep=x 

GEN=ZI2U] 


FASSWORD=x3cxxxiaac 

TJSER=3aaaaaaai: 


where: 

EXCP=x  Specifies  whether  EXCEPTIONS  are  listed 

Y  Lists  only  those  SYSOUT  groups  with  exceptional  conditions 
N  Lists  those  SYSOUT  groups  without  exceptional  conditions 
A  Lists  all  SYSOUT  groups 

This  parameter  cannotbe  specified  with  the  USER  parameter. 
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GEN=nnn  Specifies  the  absolute  or  relative  number  of  the  generation  for 

which  SYSOUT  is  listed 


If  omitted,  only  the  most  recent  generation  is  listed.  To  list 
SYSOUT  for  all  generations,  specify  an  asterisk  as  the 
generation  number. 

This  parameter  caimot  be  specified  with  the  USER  parameter. 

ID=  Specifies  the  SYSOUT  ID  of  the  SYSOUT  group  to  be  listed 

xxxxxxxxxxxx  ^  generic  ID  can  be  specified  by  appending  an  asterisk  to  the 
generic  ID.  If  omitted,  all  SYSOUT  IDs  are  listed: 

This  parameter  cannot  be  specified  with  the  USER  parameter. 

PASSWORD=  Specifies  the  same  password  as  that  specified  with  the 
xxxxxxxx  PWBATCH  initialization  parameter 

If  specified  and  the  password  matches  the  one  specified  with 
the  PWBATCH  initialization  parameter,  no  further  security 
checking  is  done,  and  all  requested  SYSOUT  groups  are  listed. 

If  omitted  or  the  password  does  not  match  the  one  specified 
with  the  PWBATCH  initialization  parameter,  the  security  user 
exit  is  invoked  to  determine  whether  the  user  is  authorized  to 
access  each  SYSOUT  group.  In  this  case,  any  SYSOUT  group 
for  which  access  is  not  au&orized  is  omitted  from  the  listing. 

Note;  Password  checking  is  not  done  for  the  LIST  command. 

USER=xxx;»:xj::rx  Specifies  the  name  of  the  user  ID  or  user  IDs  to  be  listed 

A  generic  ID  can  be  specified  by  appending  an  asterisk  to  the 
identifier. 

If  omitted,  all  user  IDs  are  listed. 

This  parameter  cannot  be  specified  with  the  ID;  GEN,  and 
SEQ  parameters. 


LOAD 


The  LOAD  control  statement  loads  an  archived  SYSOUT  group  from  tape  to  disk. 
The  SYSOUT  is  either  temporarily  loaded  to  the  CA-View  database  or  loaded  to  a 
user-defined  data  set 

If  you  use  the  expanded  access  server  for  tape  and  robotics,  and  the  server 
becomes  inactive  when  a  report  is  selected  online,  CA-View  will  LOAD  the 
report  to  disk  so  it  can  be  viewed  without  the  server. 

LOAD  jobs  should  execute  on  the  system  with  the  TYPE=PRIMARY  server; 
otherwise,  all  the  data  will  need  to  be  transmitted  across  systems  using  XCF  or 
LSERV. 
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Syntax 


For  information  about  the  expanded  access  server,  see  the  section  Expanded 
Access  Server  for  Tape  and  Robotics  in  Chapter  3,  "Configuring  CA-Vie-w." 

The  following  table  indicates  the  destination  of  the  SYSOUT  group: 


If  the  DDname 
parameter  is 

And  if  a  SARLOAD 
DD  statement  is 

Then 

Specified 

Specified  or  not 
specified 

CA-View  loads  the  SYSOUT  group  to  the 
data  set  named  with  the  DDname. 

Not  specified 

Specified 

CA-View  loads  the  SYSOUT  group  to  the 
SARLOAD  data  set. 

Not  specified 

Not  specified 

CA-View  temporarily  loads  the  SYSOUT 
group  to  the  CA-View  database  and  you 
can  view  it  online. 

The  SYSOUT  will  automatically  be 
deleted  by  the  backup  cycle  via  the 
HOLDTEMP  initialization  parameter. 

The  syntax  of  the  control  statement  is: 

/LOAD  DDHAHE^jexxxxtckx 
GEN=zmn 

TD=x3cx!ixx3aacx3a{ 

INDEX 

FASSWORDsxxxJoaacx 

SEQ=nnzi 

TAPE 

where: 


DDNAME= 

xxxxxxxx 


GEN=nnM 


Specifies  the  DD  statement  name  to  which  the  SYSOUT  group  is 
loaded 

This  parameter  overrides  the  SARLOAD  DD  statement,  if  it  is 
specified.  If  DCB  attributes  for  the  DD  statement  are  omitted, 
the  following  are  used: 

■  A  record  format  of  VBM 

■  A  record  size  of  the  SYSOUT  group  record  size  plus  four 

■  A  block  size  of  32760 

Specifies  the  absolute  or  relative  number  of  the  generation  for 
which  SYSOUT  is  loaded  to  disk 


If  omitted,  title  most  recently-archived  SYSOUT  group  for  the 
ID  loaded  to  disk. 

ID=  Specifies  the  SYSOUT  ID  of  the  group  to  be  loaded  to  disk 

XXXXXXXXXXXX  ™  .  .  .  .  J 

This  parameter  IS  required. 
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INDEX  Specifies  to  LOAD  any  page  indexes  defined  for  the  report  to 

the  disk  database 

Page  indexes  on  disk  are  used  by  the  GA-View  online  cross 
report  indexing  capability.  (The  DDname  parameter  does  not 
apply  to  page  indexes.) 

PASSWORD=  Specifies  the  same  password  as  the  one  specified  with  the 
xxxxxxxx  PWBATCH  initialization  parameter 

If  specified  and  the  password  matches  the  one  specified  with 
the  PWBATCH  initialization  parameter,  no  further  security 
checking  is  done,  and  the  requested  SYSOUT  group  is  loaded  to 
disk. 

If  omitted  or  the  password  does  not  match  the  one  specified 
with  the  PWBATCH  initialization  parameter,  the  security  user 
exit  is  invoked  to  determine  whether  the  user  is  authorized  to 
load  the  SYSOUT  group. 

SEQ=fxnn  Specifies  the  absolute  or  relative  sequence  number  of  the 

SYSOUT  group  to  be  loaded  to  disk 

If  omitted,  the  most  recently-archived  group  for  the  ID  and 
generation  specified  is  loaded  to  disk.  This  operand  is  ignored 
when  GEN  is  omitted. 

TAPE  Specifies  to  LOAD  only  from  tape. 

This  parameter  can  be  used  to  bypass  LOADing  from  optical 
disk 


PERM 


The  PERM  control  statement  sets  a  SYSOUT  group  to  permanent  status  (can  be 
used  for  long  term  archiving)  or  removes  it  from  permanent  status. 

When  the  SYSOUT  group  is  set  to  permanent  status,  its  period  of  retention  and 
its  location  are  dependent  on  the  Expanded  Retention  Option  initialization 
parameters  and  table  statements.  These  parameters  and  statements  are  processed 
during  the  CA-View  stmiied  task  backup  cycle. 

When  the  SYSOUT  group  is  removed  from  permanent  status,  it  no  longer  resides 
imder  the  control  of  the  Expanded  Retention  Option. 
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Syntax 


/PERM  DELETE 
DISK 
GEH-nnn 

TD=x3aaaaaaaaexx 

PASSWORD=xxxxxxxx 

SEQsmin 

TAPE 

where: 


DELETE  Specifies  that  the  SYSOUT  group  is  to  be  removed  from 

permanent  status 

DISK  Specifies  that  the  SYSOUT  group  is  to  be  set  to  a  permanent  "on 

disk"  status 


When  this  keyword  is  specified,  the  SYSOUT  group  must 
currently  reside  in  a  disk  or  temporary  disk  status.  This 
parameter  cannot  be  specified  with  the  DELETE  and  TAPE 
keywords.  If  the  DELETE,  DISK,  and  TAPE  ke5rwords  are 
omitted,  DISK  is  the  default. 

GEN=nnn  Specifies  the  absolute  or  relative  number  of  the  generation  of  the 
SYSOUT  group  to  be  set  to  permanent  status  or  removed  from 
permanent  status 

ID=  Specifies  the  SYSOUT  ID  of  the  SYSOUT  group  to  be  set  to 

xxxxxxxxxxxx  permanent  status  or  removed  from  permanent  status 

PASSWORD=  Specifies  the  same  password  as  the  one  specified  with  the 
xxxxxxxx  PWBATGH  initialization  parameter 

If  specified  and  the  password  matches  the  one  specified  by  the 
PWBATCH  initializationiparameter,  no  further  security 
checking  is  done,  and  the  requested  SYSOUT  group  can  be  set 
to  permanent  status  or  removed  from  that  status. 

If  omitted,  or  the  password  does  not  match  the  one  specified  by 
the  PWBATCH  initialization  parameter,  the  security  user  exit  is 
invoked  to  determine  whether  the  user  is  authorized  to  access 
the  SYSOUT  group. 

SEQ=nnn  Specifies  the  absolute  or  relative  SYSOUT  sequence  number  of 
the  SYSOUT  group  to  be  set  to  permanent  status  or  removed 
from  that  status 


TAPE  Specifies  that  the  SYSOUT  group  is  to  be  set  to  a  permanent  on 

tape  status 

This  parameter  cannot  be  specified  with  the  DELETE  and  DISK 
keywords. 
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PRINT 


Syntax 


The  PRINT  control  statement  outputs  a  SYSOUT  group  to  spool  for  printing. 
Overrides  to  the  print  attributes  can  be  specified  as  operands. 

/PRINT  BURST=jr 

C'BARS=  {xxxx  xsaat  xxxx  xsocx) 

CLASS=x 

C0PZES=iinz} 

C0PY6=  (nnn  nan  nan  nnn  nrm  nan  aaa  aaa); 

DDH%HE=XXXX}C0£X 
X>'EST=3aaaaaaix 
FCB=3aaac 
F1J^SH=  (xxxx  nan) 

FOBM=xxxx 

FORHDEF=xxxxxxxx 

GEN=iinn 

HOLD=x 

XD=xxxxxxxxxxxx 
liZNECT=2mns 
HODIFY=(XXXX  ll)i 
OPTGDJ=x 
OUTPnT=uaine 

PA6E= (nnn  nnn  nnn  nnn  rmn  nnn  aaa  aaa  nnn) 

PA6EDEF=xxxxxxxx 

PASSWORCsxxxxxxxx 

PRHODE =xxxxxxxx 

RECORD=(nnn  nnn  nnn  nnn  nnn  nnn  nnn  nnn  nnn) 

SELECT=XXXXXXXX 

SEQcnnn 

UCSsxxxx 

VlEVfpnnn 

nRITER=xxxxxxxx 

where; 


BURST=j:  Specifies  an  optional  burst  value  for  the  3800  printer  to 

override  the  one  used  to  print  the  SYSOUT 

Valid  values  are  Y  or  N. 


CHARS= 

{xxxx  xxxx  xxxx 
xxxx) 


Specifies  an  optional  set  of  character  arrangement  table  names 
for  the  3800  printer  to  override  those  used  to  print  the  SYSOUT 

A  value  of  1  to  4  names  separated  by  one  or  more  blanks 
and/ or  commas  and  enclosed  in  parentheses  can  be  specified. 


CLASS= 


Specifies  an  optional  class  to  override  the  one  used  to  print  the 
SYSOUT 


GOPIES=nnn  Speciffes  an  optional  number  of  copies  to  override  the  one 
used  to  print  the  SYSOUT 

A  range  of  1  to  255  can  be  specified. 
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COPYG=(nnn 
nnn  nnn  nnn  nnn 
nnnnnnnnn) 


DDNAME= 

xxxxxxxx 


IMST=xxxxxxxx 


FCB=a:x3:3: 

FLASH= 

(xxxxnnn) 


FORM=xa:3:x 

FORMDEF= 

xxxxxxxx 


GEN=nnn 


HOLD=a: 


Specifies  an  optional  set  of  copy  groups  for  the  3800  printer  to 
override  those  used  to  print  the  SYSOUT 

A  range  of  1  to  8  copy  groups  separated  by  one  or  more 
blanks  and/or  commas  and  enclosed  in  parentheses  can  be 
specified.  Each  copy  group  value  must  be  in  the  range  of  1  to 
255. 

Specifies  the  DD  statement  name  to  which  the  SYSOUT  group 
is  printed 

If  the  DCB  attributes  for  the  DD  statement  are  omitted,  the 
following  values  are  used: 

■  A  record  format  of  VBM 

■  A  record  size  of  the  SYSOUT  group  record  size  plus  4  but 
not  less  than  137 

■  A  blocksize  of  32760 

Specifies  an  optional  destination  to  override  the  one  used  to 
print  the  SYSOUT 

The  destination  can  be  a  synon}m  created  via  the  online 
DEFine  DEVice  command. 

Specifies  an- optional  forms  control  image  to  override  the  one 
used  to  print  the  SYSOUT 

Specifies  an  optional  forms  flash  overlay  name  and  flash  count 
for  the  3800  printer  to  override  those  used  to  print  the  SYSOUT 

The  forms  flash  overlay  name  and  copy  count  are  separated 
by  one  or  more  blanks  and/or  commas  and  are  enclosed  in 
parentheses. 

Specifies  an  optional  forms  name  to  override  the  one  used  to 
print  the  SYSOUT 

Specifies  a  library  member  containing  statements  to  control 
printing  of  the  SYSOUT  data  on  the  3800  printer 

The  statements  can  specify  overlay  forms,  page  location  for 
overlays,  and  page  format  suppressions  that  can  be  activated. 

Specifies  the  absolute  or  relative  number  of  the  generation  for 
which  SYSOUT  is  printed 

If  omitted,  the  most  recently-archived  SYSOUT  group  for  the 
ID  is  printed. 

Specifies  either  Y  or  N  to  indicate  whether  the  SYSOUT  is  to  be 
placed  on  the  hold  queue  for  printing 

If  omitted,  HOLD=N  is  assumed. 
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ID= 

xxxxxxxxxxxx 

LINECT=nMnn 

MODIFY= 
{xxxx  n) 


OPTCDJ=:k 


OUTPUT= 

xxxxxxxx 


PAGE=(nnn  nnn 
nnn  nnn  nnn  nnn 
nnn  nnn  nnn) 


PAGEDEF= 

xxxxxxxx 


Specifies  the  SYSOUT  ID  of  the  group  to  be  printed 
This  parameter  is  required. 

Specifies  the  maximum  number  of  lines  to  be  printed  on  each 
output  page 

Specifies  an  optional  copy  modification  module  name  and 
table  reference  character  for  the  3800  printer  to  override  those 
used  to  print  the  SYSOUT 

The  copy  modification  module  name  and  table  reference 
character  are  separated  by  one  or  more  blanks  and/or 
commas  and  are  enclosed  in  parentheses.  The  table  reference 
character  can  have  a  range  of  0  to  3. 

Specifies  an  optional  override  as  to  whether  the  SYSOUT 
records  contain  table  reference  characters  for  the  3800  printer 

Valid  values  are  Y  or  N. 

Specifies  the  name  of  the  / /OUTPUT  statement  to  be  used  for 
printing  the  SYSOUT  group 

This  parameter  overrides  the  specifications  of  the  FORMDEF, 
LINECNT,  PAGEDEF,  PRMODE,  and  possibly  FORM 
parameters.  The  parameter  {xxxxxxxx)  data  is  specified  as 
follows; 
name 

stepaame . name 

stepname  .procstepname .  name 

An  asterisk  can  proceed  the  parameter  data  to  match  the  JGL 
specification  of  the  OUTPUT  parameter. 

Specifies  1  to  9  page  numbers  and/or  ranges  of  pages  to  be 
printed 

The  page  numbers  and/or  ranges  of  pages  are  separated  by 
one  or  more  blanks  and/ or  commas  and  are  enclosed  in 
parentheses.  A  range  of  pages  is  specified  as  two  page 
numbers  separated  by  a  colon.  If  both  PAGE  and  RECORD  are 
omitted,  the  entire  SYSOUT  group  is  printed. 

Specifies  a  library  member  containing  statements  to  control 
printing  of  the  SYSOUT  data  on  the  3800  printer 

The  statements  can  specify  logical  page  length  and  width, 
fonts,  and  page  segments. 
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PASSWORD=xa:  Specifies  the  same  password  as  the  one  specified  with  the 
xxxxxx  PWBATGH  initialization  parameter 

If  specified,  and  the  password  matches  that  of  the  PWBATCH 
initialization  parameter,  no  further  security  checking  is  done, 
and  the  requested  SYSOUT  group  is  printed.  If  omitted,  or  the 
password  does  not  match  the  one  specified  with  the 
PWBATCH  initialization  parameter,  the  security  user  exit  is 
invoked  to  determine  whether  the  user  ID  authorized  to  print 
the  SYSOUT  group. 


PRMODE= 

xxxxxxxx 

Specifies  the  process  mode  required  for  printing  the  SYSOUT 
group 

RECORD=(nnM 
nnn  nnn  nnn  nnn 

Specifies  1  to  9  record  numbers  and/or  ranges  of  records  to  be 
printed 

nnn  nnn  nnn 
nnn) 

The  record  numbers  and/ or  ranges  of  records  are  separated 
by  one  or  more  blanks  and/ or  commas  and  are  enclosed  in 
parentheses.  A  range  of  records  is  specified  as  two  record 
numbers  separated  by  a  colon.  If  both  PAGE  and  RECORD  are 
omitted,  the  entire  SYSOUT  group  is  printed. 

SELECT= 

xxxxxxxx 

Specifies  the  page  separation  index  value  for  selecting  pages  to 
print 

If  the  value  contains  any  of  the  special  characters:  blank, 
comma,  or  single  quote,  it  must  be  enclosed  within  single 
quotes.  A  single  quote  must  be  represented  as  two  single 
quotes. 

SEQ=nnn 

Specifies  the  absolute  or  relative  SYSOUT  sequence  number  of 
the  SYSOUT  group  to  be  printed 

If  omitted,  the  most  recently-archived  SYSOUT  group  for  the 
ID  and  generation  specified  is  printed.  This  is  ignored  when 
GEN  is  omitted. 

UGS=x3:xa: 

Specifies  an  optional  special  character  set  name  to  override  the 
one  used  to  print  the  SYSOUT 

VIEW=nnn 

Specifies  a  view  format  in  which  report  is  printed,  where  n  =  1 
to  255 

WRITER^ 

xxxxxxxx 

Specifies  the  external  writer  name  to  be  used  for  printing  the 
SYSOUT  group 
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SARBCH  Examples 


Example  1 


Example  2 


The  two  most  recent  generations  of  archived  SYSOUT  are  listed. 

//EXAMPLE!  JOB  ACCOQNT, PR06KAMMER 
//STEP!  EXEC  PGM=SASBCH 

/ /STEPLIB  DD  DSN=CR1 . CAILIB , DISP=SHS 
//SYSPRINT  DD  SYSOUS=* 

//REPORT  DD  SYSOUT=* 

//SYSIN  DD  * 

/DBASE  HAHE=VXEW. SYSTEM! 

/LIST 

/LIST  GEN=-! 

/* 

The  most  recent  SYSOUT  group  for  job  A0627WE  is  printed  to  special  forms 
2PT. 

//EXAMPLE2  JOB  AGCODMT, PROGRAMMER 
//STEP!  EXEC  P<ai=SARBCH 

//STEPLIB  DD  DSI1=CAI. CAILIB, DISP=SHR 
//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

/DBASE  NAME=VIEW. SYSTEM! 

/PRINT  ID=A0627WE  FORM=2PT 
/* 


Example  3 


The  report  having  a  SYSOUT  ID  of  M35AST03R1  created  two  generations  ago  is 
loaded  to  existing  data  set  USER.M35AST03.R1. 

//EXAMPLES  JOB  ACCOUNT, PROGRAMMER 

//STEP!  EXEC  PGM=SASBCH,PARM= 'VIEW. SYSTEM!' 

//STEPLIB  DD  DSNsCAI. CAILIB, DISP=SHR 
//SARLOAD  DD  DSN=USBR.M35AST03 .R!,DISP=OLD 
//SYSPRINT  DD  SYSOUT=* 

//SYSIN  DD  * 

/LOAD  ID=A3SAST03R!  GEN=-2 
/* 
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Using  the  Optical  Disk  Interface 


In  This  Chapter 

This  chapter  covers  the  following  topics: 

■  Optical  disk  page-level  access 

■  Configuring  the  optical  disk  interface 

■  Operating  the  optical migration  subtask 

■  Submitting  the  optical  migration  batch  job 

■  Optical  disk  drivers 

■  Optical  disk  database  maintenance 


Overview 


CA-View  provides  optional  drivers  that  enable  you  to  archive  SYSOUT  data  to 
the  following: 

■  FileTek  Optical  Disk  Storage  Machine 

■  Kodak  Optistar  Storage  System 

■  IBM  3995  Optical  Library  Dataserver,  models  131, 132, 133,  and  153 

Using  the  CA-View  optical  disk  driver  also  enables  you  to  retrieve  data  from 
optical  disk  to  the  CA-View  database  for  viewing  or  printing. 

Once  you  have  configured  CA-View  to  use  an  optical  disk  driver,  CA-View 
archives  SYSOUT  data  to  three  levels  of  storage: 

■  Primary  disk  (the  CA-View  database) 

■  Secondary  disk  (optical  disk;  saved  using  the  driver) 

■  Tape  storage  (CA-View  archival  tapes) 


Using  the  Optical  Disidnterface  10-1 


Overview 


What  Is  Secondary  Disk  Storage? 

Secondary  disk  storage  is  a  storage  alternative  to  the  CA- View  primary  disk 
database.  You  can  specify  an  optical  disk  device  as  a  destination  for  SYSOUT 
archiving.  This  lets  you  create  a  more  portable  and  permanent  backup  for 
reports. 

Note:  In  this  document,  the  terms  secondary  storage  and  optical  disk  storage  are 
used  interchangeably. 


When  to  Use  Secondary  Disk  Storage 

Choose  a  destination  for  SYSOUT  group  archiving  based  upon  retrieval 

frequency  and  retention  period. 

■  Use  primary  disk  storage  for  storing  SYSOUT  groups  that  you  must  view  on  a 
frequent  basis  so  that  the  SYSOUT  group  is  always  available  for  immediate 
retrieval.  Also,  any  SYSOUT  group  with  a  relatively  short  retention 
requirement  is  a  candidate  for  primary  disk  storage,  since  primary  disk  space 
is  reusable  and  the  space  quickly  becomes  available  again. 

■  Use  secondary  disk  storage  (optical  disk)  for  archiving  any  SYSOUT  group  with 
a  relatively  long  retention  period  or  that  is  not  frequentiy  required  for 
viewing.  When  an  optical  disk  is  used  for  this  kind  of  storage,  it  is  an 
extremely  reliable  and  cost  effective  medium. 

■  Use  tape  storage  to  back  up  SYSOUT  groups  on  primary  or  secondary  disk. 


Requirements 


The  system  requirements  for  the  CA-View  Optical  Disk  Interface  are  as  follbws: 

■  SAR  6.0  or  higher  or  CA-View  1.7  (or  higher),  and  the  CA-View  Expanded 
Retention  Option  (ERO)  are  required  to  use  any  of  the  optical  disk  interfaces. 

■  The  Kodak  Optistar  Storage  System  page  level  driver  requires  the 
Data/ Ware  Multi-user  Data  Retrieval  Subsystem  (MDRS). 

■  The  FileTek  drivers  require  the  FileTek  callable  interface  (module 
ESMCALL). 

■  The  OAM  driver  requires  that  OAM  is  running,  and  that  all  CA-View 
transactions  occur  on  the  system  that  is  running  OAM.  This  involves  the 
following: 

-  The  CA-View  archival  started  task  must  execute  on  the  system  with 
OAM  if  either  the  CA-View  backup  cycle  or  optical  migration  subtask 
does  the  migration  to  OAM. 
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-  All  online  users  selecting  SYSOUT  groups  from  secondary  disk  storage 
must  be  executing  on  the  system  with  OAM. 

Users  on  another  system  can  load  the  SYSOUT  group  from  secondary 
disk  to  the  CA-View  database  in  order  to  access  it.  The  SARBCH  job  used 
to  load  the  SYSOUT  group  must  rim  on  the  system  with  OAMi 

-  All  SARBCH  jobs  requesting  SYSOUT  groups  from  secondary  disk 
storage  must  execute  on  the  system  with  OAM. 


Report-  Level  Versus  Page-  Level  Access 

When  you  select  a  SYSOUT  group  from  CA-View  that  shows  a  status  of  DSK2, 
PRDK2,  or  PRM2  (all  of  which  indicate  optical  disk  secondary  storage),  CA-View 
does  one  of  the  following: 

■  Allows  you  to  view  or  print  the  SYSOUT  file  directly  from  optical  disk  (page- 
level  access) 

■  Loads  the  entire  SYSOUT  from  the  optical  disk  into  the  CA-View  database 
(report-level  access) 

Most  of  the  information  in  this  document  applies  to  both  types  of  drivers.  For 
more  information  about  page-level  access,  see  Optical  Disk  Page-Level  Access 
later  in  this  chapter. 


Driver  Names  and  Types 

CA-View  currently  supports  the  following  optical  disk  drivers: 

■  SARD2D00  for  IBM  DASD  Emulation  Optical  devices  (including  the 
ESA/370  and  ESA/390  3995  model  153  Optical  Library  Dataserver)  with 
page-level  access 

■  SARD2D01  for  the  Kodak  Optistar  Storage  System  with  report-level  access 

■  SARD2D02  for  the  FileTek  Optical  Disk  Storage  Machine  with  report-level 
access 

■  SARD2D03  for  the  FileTek  Optical  Disk  Storage  Machine  with  page-level 
access 

■  SARD2D04  for  the  Kodak  Optistar  Storage  System  optical  disk  device  with 
page-level  access 

■  SAKD2D05  for  IBM  Object  Access  Method  (OAM)  devices  (including  the 
ESA/370  and  ESA/390  3995  models  131, 132,  and  133  Optical  Library 
Dataserver)  with  page-level  access 
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Optical  Disk  Page- Level  Access 

This  section  covers  the  drivers  that  enable  page-level  access  and  explains  how 
page-level  access  works. 


Drivers 

Page-level  access  is  currently  available  with  the  following  drivers: 

■  SAIUD2D00  driver  for  IBM  DASD  Emulation  Optical  devices  (including  the 
IBM  ESA/370  and  ESA/390  3995  Optical  Library  Dataserver,  model  153) 

■  SARD2D03  driver  for  the  FileTek  Storage  Machine 

■  SARD2D04  driver  for  the  Kodak  Optistar  Storage  System 

■  SARD2D05  driver  for  OAM  devices  (including  the  IBM  ESA/370  and 
ESA/390  3995  Optical  Library  Dataserver,  model  132) 

Purpose 

The  CA-View  Optical  Disk  Interface  offers  enhanced  functionality  that  enables 
you  to  access  archived  SYSOUT  data  directly  from  optical  disk  secondary 
storage.  This  capability  is  caUed  page-level  access,  to  distinguish  it  from  report-level 
access,  in  which  an  entire  SYSOUT  must  be  loaded  into  the  CA-View  database  for 
viewing. 

This  capability  helps  you  reduce  the  DASD  load  at  your  site  while  minimizing 
the  performance  impact  of  ttie  slightly  slower  access  speed  of  optical  disk. 
Instead  of  loading  a  100,000-line  report  back  to  the  CA-View  database,  you  can 
view  or  print  just  the  data  you  need. 

Operation 


With  page-level  access,  you  can  add  indexes  to  your  SYSOUT  archives  at  archive 
time.  The  optical  disk  interface  uses  these  user-defined  indexes  to  reduce  optical 
disk  access  time,  minimizing  the  performance  impact  of  the  slightly  slower  access 
speed  of  optical  disk.  The  net  result  is  that,  depending  on  your  indexing  and  the 
number  of  concurrent  access  requests  to  optical  disk,  the  response  time  can  be 
indistinguishable  from  viewing  records  from  primary  storage. 
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Configuring  the  Optical  Disk  Interface 

These  instructions  provide  an  overview  of  the  steps  required  to  configure 
CA-View  to  use  the  optical  disk  storage  drivers.  Each  of  the  information  blocks  in 
this  section  apply  to  all  CA-View  optical  disk  drivers,  /unless  indicated  otherwise 
by  the  block  label  (for  example,  the  DSK2PARM:  parameter  explanation  in  the 
following  section). 

Important!  Read  the  instructions  thoroughly  before  attempting  the  configuration. 


Overview  of  Configuration  Steps 

This  section  presents  an  overview  of  the  steps  you  must  perform  to  configure 
CA-View  to  use  the  optical  disk  interface.  These  steps  are  detailed  in  the  sections 
that  follow. 

1.  Use  the  SARINIT  initialization  parameter 

DSK20RVR 

to  specify  which  optical  disk  driver  you  will  be  using. 

2.  Use  the  SARINIT  initialization  parameter 
DKS2PASH 

to  specify  the  page-level  drivers. 

3.  Set  optical  migration  options  in  the  ERO  table  (in  conjunction  with  disk  and 
tape  migration  options),  using  the  following  keywords: 

DSK2DAYS 

DSK2NOTP 

4.  You  can  customize  optical  migration  scheduling  with  the  following 
initialization  parameters: 

DSK2HXGD 

DSK2TIHE 

DSK2IIITV 

Note:  By  default,  the  CA-View  backup  cycle  performs  all  optical  migration. 

5.  Run  SARINIT  to  implement  your  initialization  parameter  settings  to  the 
database. 
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Step  1 .  Specify  the  Optical  Disk  Storage  Driver  ^ 

Specify  which  optical  disk  driver  you  will  be  using  with  the 
DSK2DRVR 

SARINIT  initialization  parameter. 

This  parameter  is  required;  there  is  no  default  value. 

Syntax  DSK2DRVR=SAKD2D0n 

where; 


SARD2D00 

SARD2D01 

SARD2D02 

SARD2D03 

SARD2D04 

SARD2D05 


IBM  ESA/370  and  ESA/390  3995  Optical  Library  Dataserver,  model 
153,  page-level  access 

Kodak  Optistar  report-level  access 

FileTek  report-level  access 

FileTek  page-level  access 

Kodak  Optistar  page-level  access 

IBM  ESA/370  and  ESA/390  3995  Optical  Library  Dataserver,  models 
132  and  133,  page-level  access 


Step  2.  Configure  the  Page- Level  Drivers 


Specify  the  appropriate  values  for  the 

DSK2FARH 


SARINIT  initialization  parameter. 

The  values  for  each  of  the  drivers  are  explained  in  the  sections  that  follow, 


DSK2PARM;  IBM  Page-Level  Driver  for  Models  1 31 , 132, 1 33 

Specify  the  high-level  index  prefix  for  creating  the  collection  and  object  names  for 
OAM. 

Syntax  BSKZ'PRSa^index/storclas/mgmtclas/dbZid 

The  index  can  consist  of  a  maximum  of  17  characters.  The  default  value  for  index 
is  the  high-level  index  of  the  GA-View  database.  Specify  the  SMS  storage  class  as 
storclas. 
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Specify  the  SMS  management  class  as  mgmtclas.  Specify  ihe  DB2  system  identifier 
as  dblid.  This  identifier  must  match  that  specified  on  the  SMS  subsystem 
definition  in  member  lEFSSNNxx  in  SYSl.PARMEIB. 


DSK2PARM:  IBM  Page  Level  Driver  for  Model  153 

Specify  the  high-level  index  prefix  for  creating  the  optical  disk  data  sets. 

Syntax  DSK2PASM=iadex/uiiit/Jbl]fcsize 

The  index  can  consist  of  a  maximum  of  17  characters.  If  you  change  the  index, 
older  data  sets  will  have  to  be  renamed  with  the  new  index  name  to  be  accessible. 
You  can  choose  to  set  up  a  special  user's  catalog  for  aU  of  these  MVS  data  sets. 
The  default  value  for  index  is  the  high-level  index  of  the  CA-View  database. 
Specify  the  unit  name  of  the  pool  of  optical  disk  volumes  as  i/nif.  Specify  the 
block  size  to  be  used  as  blksize.  The  default  is  1/2  track  3390. 


DSK2PARM;  Kodak  Optistar  Page  Level  Driver 

Specify  the  imit  name  of  the  optical  disk  for  unit. 
Syntax  DSK2  PAKM=!  unit  /  volserl  /  volserZ  (said 


Whenever  a  new  emulated  tape  is  required  for  archival,  the  next  tape  in  the  range 
is  used.  When  the  end  of  the  range  is  reached,  the  first  tape  in  the  range  is  used. 
The  range  of  emulated  tape  volumes  must  have  been  previously  defined  and 
initialized  within  the  optical  disk  device.  Specify  the  MDRS  one-character 
subsystem  identifier  for  ssid.  The  default  ssid  is  S. 


Specify  the  lowest  voltime  serial  number  in  the  range  as  volserl  and  the  highest 
volume  serial  munber  in  the  range  as  volserl.  The  serial  numbers  for  the  range  of 
emulated  tape  volumes  must  be  the  same  length,  must  end  with  one  or  more 
digits,  and  must  have  matching. begirming  alphabetic  characters  (if  any). 
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DSK2PARM:  FileTek  Drivers 

Specify  the  high-level  index  prefix  for  creating  file  names  on  the  Storage  Machine 
as  INDEX.  The  syntax  is  as  follows; 

Syntax  DSK2PAB11=  index/ accoimC/passtirord/sinid 

The  index  can  consist  of  a  maximrim  of  17  characters.  The  default  value  for  index 
is  the  high-level  index  of  the  CA-View  database.  The  value  for  account  specifies 
the  accoimt  identification  code  for  the  storage  machine  as  account  and  can  be  a 
maximum  of  8  characters.  The  value  iox  password  specifies  the  accoimt  password 
for  the  storage  machine  and  can  be  a  maximum  of  8  characters.  The  value  for  smid 
specifies  the  storage  machine  identifier  and  can  be  a  maximum  of  6  characters. 

Example:  FileTek  To  use  the  default  storage  machine,  omit  the  SMID  parameter.  For  example: 

DSK2PARM 

DSK2PABM=SARP .  SYSTEHI/VXEW/SARPSVID 

This  example  specifies  an  index  prefix  of  VIEW.SYSTEMl,  an  account 
identification  code  of  VIEW,  an  account  password  of  SAKPSWD,  and  a  default 
smid. 


V- 


DSK2PARM:  Kodak  Optistar  Report  Level  Driver 

Specify  the  unit  name  of  the  optical  disk  for  UNIT.  The  syntax  is  as  follows: 

Syntax  DSK2  PABH= uni  t /volaerl  /  vol8er2 

Specify  the  lowest  volume  serial  number  in  the  range  as  volserl  and  the  highest 
volume  serial  number  in  the  range  as  volserl.  The  serial  numbers  for  the  range  of 
emulated  tape  volumes  must  be  the  same  length,  must  end  with  one  or  more 
digits,  and  must  have  matching  beginning  alphabetic  characters  (if  any). 

Whenever  a  new  emulated  tape  is  required  for  archival,  the  next  tape  in  the  range 
is  used.  When  the  end  of  the  range  is  reached,  the  first  tape  in  the  range  is  used. 
The  range  of  emulated  tape  volumes  must  have  previously  been  defined  and 
initialized  within  the  optical  disk  device. 


•■■■'  !  ■  ■, 
'O' 


Adding  the  MOUNT  Attribute:  Kodak  Optistar  Report  Level  Driver  Only 

This  step  is  optional.  Because  the  Kodak  Optistar  optical  disk  device  appears  to 
the  system  as  a  tape  device,  the  emulated  tape  volumes  must  be  mounted  before 
being  accessed.  If  you  are  using  the  report-level  driver  and  you  intend  to  allow 
TSO  users  to  access  SYSOUT  groups  on  optical  disk  storage,  you  must  assign  the 
moxmt  attribute  to  those  TSO  users. 
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Consultyour  optical  disk  device  documentation  for  possible  alternatives  to 
setting  the  mount  attribute.  The  TSO  ACCOUNT  command  can  be  used  to  assign 
the  mount  attribute  as  follows: 

ACCOUNT 

C  (user  XD)  MOUNT 
END 

The  Kodak  Optistar  page  level  driver  uses  the  services  of  MDRS,  which  performs 
the  mounts  automatically  for  the  TSO  user.  Do  not  assign  the  moimt  attribute  for 
users  of  the  page-level  driver. 


Step  3.  Set  Initialization  and  ERO  Table  Parameters 

Set  optical migration  options  in  the  ERO  table  (in  conjunction  with  disk  and  tape 
migration  options)  using  the  following  keywords: 

DSK2DAYS 

DSK2NOTP 

The  values  for  these  ke5WGrds  are  explained  in  the  following  sections. 


DSK2DAYS:  Initialization  Parameter  and  ERO  Table  Parameter 

The  DSK2DAYS  ERO  table  parameter  specifies  the  number  of  days  a  SYSOUT 
group  with  expanded  retention  status  is  to  remain  on  primary  disk  before  it  is 
migrated  to  secondary  disk  and  deleted  from  primary  disk. 

Syntax  DSK2nAYs=imn 

Only  SYSOUT  groups  with  permanent  retention  status  are  eligible  for  migration 
to  optical  disk.  See  &e  section  Writing  ERO  Table  Statements  in  Chapter  6, 
"Expanded  Retention  Option,"  for  mformation. 

The  DSK2DAYS  SARINIT  initialization  parameter  sets  a  global  default  for  a 
CA-View  database.  See  the  section  Setting  and  Changing  Initialization 
Parameters  in  Chapter  2,  "Initialization  Parameters,"  for  information  on  using 
SARINIT. 

Setting  DSK2DAYS=0  specifies  that  SYSOUT  groups  are  to  be  migrated  to  optical 
disk  with  the  next  scheduled  optical  migration.  The  default  is  999,  which  specifies 
that  SYSOUT  groups  are  never  to  be  migrated  to  optical  disk. 
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DSK2NOTP:  ERO  Table  Parameter 

The  DSK2NOTP  ERO  table  parameter  specifies  that  once  a  report  resides  on 
optical  disk,  the  tape  backup,  if  it  exists,  is  deleted.  If  the  parameter  is  not 
specified,  tape  backups  are  still  maintained. 

Syntax  dskznotp 

Exampie  Specify 

DSK2NOTP  DSK2DAYS=0 

to  indicate  that  no  tape  backup  will  ever  be  created  by  the  SAR  standard  backup 
cycle.  If  you  specify  for  the  CA-View  backup  cycle  to  perform  optical  migration 
(B  value  for  DSK2MIGD  initialization  parameter),  and  an  INTERIM  backup  runs 
before  the  report  migrates  to  optical,  the  report  will  be  backed  up  to  tape. 


Customization  via  SARDOOUX  User  Exit 

Sites  that  use  the  IBM  model  3995 153  optical  drives  can  code  user  exit 
SARDOOUX  to  completely  customize  optical  migration.  SARDOOUX  has  access  to 
all  attributes  of  the  report,  as  contained  in  the  GGR  (group  control  record). 

Possible  applications  are: 

■  Reports  that  are  imder  25K  do  not  migrate  to  optical 

■  Reports  that  are  over  3M  do  not  migrate  to  optical 

See  the  comments  m  the  source  code  of  SARDOOUX  for  specifications. 


Migration  Options 

You  have  many  options  for  how  and  when  reports  will  be  migrated  to  optical 
disk.  The  following  is  a  list  of  possible  migration  needs,  and  how  to  implement 
them.  Migration  to  optical  means  that  a  report  on  primary  disk  is  written  to 
optical,  and  then  deleted  from  primary  disk. 


Reports  with  these  requirements  Should  have  these  ERO  statements 

(Report  ID- DAILY)  /daily  dretpd=3  eetpd=180 

■  Stay  on  primary  disk  for  3  days 

■  Stay  on  tape  backup  for  6  months 

■  Never  go  to  optical  disk 

Continued 
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Continued _ 

Reports  With  these  requirements  Shouid  have  these  ERO 

statements 


(Report  ID:  MONTHEMD) 

■  Stay  on  primary  disk  for  30  days 

■  Migrate  to  optical  after  30  days,  and  stay 
for  7  years 


/MONTHBND  EETPD=2557 
DSK2DAYS=30  ALL 

DRETPD  includes  both  primary 
(DASD)  and  secondary  (optical) 
disk  retention; 


■  Are  also  kept  on  tape  backup  for  7  years 


(Report  ID:  QRTREND) 


/QRTREND  RETPD=2557 
DSK2DAYS=90  DSK2NOTP  ALL 


Stay  on  primary  disk  and  tape  backup  for 
90  days 

Migrate  to  optical  ajfter  90  days,  and  stay 
there  for  7  years 

Are  deleted  from  tape  backup  when 
migrated  to  optical 


When  you  use  DSIC2NOTP,  disk 
retention  (DRETPD,  DGENS, 
DCOPIES)  and  tape  retention 
(RETPD,  TGENS,  TCOPIES)  should 
be  equal.  In  this  example,  even 
though  RETPD=2557,  the  reports 
are  deleted  from  tape  when  they  go 
to  optical  (90  days). 


(Report  ID:  BIGRPT) 


/BIGRPT  DSK2DAYS=0  RETPD=2557 
t>SK2I10TP  ALL 


Migrate  to  optical  from:  primary  disk  at 
the  next  opportunity" 

Stay  on  optical  for  7  years 

Are  never  backed  up  to  tape 


The  reports  are  never  backed  up  to 
tape,  unless  an  interim  backup 
cycle  is  nm  before  the  report 
migrates  to  optical. 


Step  4.  Customize  Optical  Migration  Scheduling  (Optional) 

Optionally  customize  optical  migration  scheduling  with  the  following 
parameters: 

DSK2MI6D 

DSK2TZHE 

DSK2INTV 

These  parameters  work  in  conjimction  with  the  DAYS  initialization  parameter, 
which  defines  when  the  CA-View  backup  cycle  (migration  to  tape)  will  occur. 
You  can  set  a  separate  opticalmigration  schedule  for  each  day  of  the  week. 

For  automatic  migration  by  the  optical  migration  subtask,  you  can  specify  ranges 
of  time  for  migration  to  occur,  and  ranges  of  idle  time. 

This  step  is  optional.  By  default,  the  CA-View  backup  cycle  performs  all 
migration  to  optical  disk. 
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The  DSK2MIGD  specifies  the  type  of  optical  migration  to  occur  on  each  day  of 
the  week  beginning  with  Monday.  The  syntax  is  as  follows: 

Syntax  DSK2MIGD=xx3£Xia« 

where: 


A  Specifies  automatic  scheduling;  migration  occurs  during  the  time 
setbyDSK2TIME 

Note:  The  optical  migration  subtask  scans  the  database 
intelligently  (not  a  repeat  full  pass  each  time),  so  processing  time  is 
minimized. 

If  a  time  range  specified  by  DSK2TIME  goes  across  midnight  (for 
example,  Friday  11  PM  to  2  AM  Saturday),  only  the  day  that  the 
range  begins  (Friday)  needs  to  be  specified  wUh  an  A. 

M  Specifies  that  no  automatic  scheduling  occurs 

Optical  migration  occurs  when  it  is  manually  requested,  via  the 
operator  commands  to  the  optical  migration  task. 

B  Specifies  that  optical  migration  is  performed  by  the  CA-View 
standard  backup  cycle 

N  Specifies  that  no  backup  migration  is  to  occur,  even  if  the  operator 
commands  are  issued  to  start  up  the  optical  migration  task 

This  option  is  provided  so  that  you  can  have  times  of  ensuring  that 
no  optical  migration  will  occxar. 

The  default  is  BBBBBBB; 


Scheduling  Parameters:  DSK2TIME 

The  DSK2TIME  parameter  specifies  the  time  intervals  during  which  optical 
migration  will  automatically  occur. 

Syntax  DSK2TZHE=2innn-nnzin,» 

Automatic  migration  is  activated  by  an  A  value  for  the  DSK2MIGD  parameter. 
Up  to  four  ranges  can  be  specified. 

The  default  is  0000  to  2400. 
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Scheduling  Parameters:  DSK2INW 

The  DSK2INTV  parameter  specifies  the  amoimt  of  time  the  optical  migration  task 
will  wait  (idle  time)  before  scanning  the  database  again. 

Syntax  DSK2niTv=iimm 

This  parameter  works  in  conjimction  with  the  DSK2MIGD  and  DSK2TIME 
parameters,  to  schedule  automatic  optical  migration.  Automatic  migration  is 
activated  by  an  A  value  for  the  DSK2MIGD  parameter.  DSK2INTV  is  also  used  as 
the  idle  time  interval  whenever  the  optical migration  task  is  manually  started. 

The  default  is  0015. 


Scheduling  Optical  Migration 

You  have  many  options  for  scheduling  optical  migration.  The  following  is  a  list  of 
possible  scheduling  needs,  and  how  to  implement  them: 


Optical  migration  occurs 

When  you  specify  these  parameters 

■  Each  night  by  the  CA-View 
standard  backup  cycle 

t)SK2MXGDsBBBBBBB 

DAYSsYrrrriY 

The  DAYS  initialization  parameter 
determines  what  days  of  the  week  the 
CA-View  backup  cycle  will  run. 

■  Automatically,  by  the  optical 
migration  subtask,  Monday 
through  Friday  only 

DSK2UXGD=AAAAANH 

DSK2XI1TV=:0045 

DSK2TXME=2100-2300> 0100-0500 

■  Every  45  minutes  from  9  PM  to 
11  PM,  and  every  45minutes 
from  1  AM  to  5  AM. 


■  When  the  system  administrator  dsk2migd=mmmmmmm 
manually  invokes  the  optical 
migration  subtask  (no  automatic 
migration) 
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Step  5.  Run  SARINIT 

Rim  SARDSIIT  to  set  the  initialization  parameters  you  specified  in  Step  3  for  the 
database. 

For  information  on  setting  the  initialization  parameters  for  a  GA-View  database 
by  running  SARINIT,  see  the  section  Setting  and  Changing  Initialization 
Parameters  in  Chapter  2,  "Initialization  Parameters." 


Operating  the  Optical  Migration  Subtask 

Optical migration  can  be  done  as  follows: 

■  By  the  backup  cycle  (disk  to  tape) 

■  By  a  batch  job  (SARDSK2B) 

■  By  the  optical  migration  subtask  of  the  CA-View  started  task 

The  optical  migration  subtask  can  be  either  automatically  scheduled  or  manually 
invoked.  The  following  commands  are  available  for  operating  the  subtask. 


Starting  the  Optical  Migration  Subtask 

Issue  the  following  operator  command  to  start  the  optical  migration  subtask: 
F  SARSTG,DSK2  START 


Stopping  the  Optical  Migration  Subtask 

Issue  the  following  operator  command  to  terminate  the  optical  migration  subtask: 

F  SARSTC,DSK2  STOP 

Resuming  Automatic  Optical  Migration 

After  the  optical  migration  subtask  has  been  stopped  by  the  DSK2  STOP 
parameter,  you  can  resume  the  automatic  migration  schedule  by  issuing  the 
following  operation  command: 

F  SARSTG,DSK2  RRSUHE 

Note:  Automatic  migration  is  determined  by  the  DSK2MIGD,  DSK2TIME,  and 
DSK2INTV  parameters. 
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Submitting  the  Optical  Migration  Batch  Job 


Submitting  the  Opticoi  Migration  Batch  Job 

You  can  submit  the  following  batch  job  (in  member  SARDSK2B  of 
CAI.PPOPTION)  to  perform  a  single  pass  of  the  CA-View  disk  database,  and 
migrate  any  reports  destmed  for  optical: 

//EXaHFLE  JOB  ACCOtlIlT,PROGRAHMER 

//SARBSK2B  EXEC  F6H=SARDSK2B,PARH= 'VIEW. SYSTEM!' 

//STEPLIB  DD  DSH=CAI.GAXLXB,DISP=SHR 

//SARDSLST  DD  SYSOBT=X, DCB=BLKS1ZE=1210 

//SARPATAB  DD  DSN=VIEW. SYSTEM! . SARPATAB(ERO), DISP=SHR 

In  the  SARDSK2B  statement,  specify  your  CA-View  database  as: 

PARH= ' dhase . name ' 


SARD2LST  DD  Statement:  Migration  Report 


The  SARD21LST  DD  statement  is  optional.  It  creates  the  SARD2LST  report,  which 
lists  any  reports  that  were  migrated  to  optical.  Here  is  an  example  of  die  report: 


SARD2LST 

CA- 

VIEW  (2.0) 

PAGE  1 

09/19/95  19:58:47  REPORTS 

MIGRATED  TO  SECONDARY  DISK  - 

BATCH  JOB 

ZD 

JOB  MAKE  JOBID 

GEN 

SEQ  ARC  DATE 

ARC  TIME 

PAGES 

LINES 

MIGRATED 

PAQ 

CBROERIA  JOB09130 

10 

52  09/19/95 

19:53:21 

1 

10 

19:58:47 

AAC 

CBROERZA  JOB09129 

10 

45  09/19/95 

19:53:16 

1 

10 

19:58:47 

AAC 

CBROERIA  JOB09128 

10 

38  09/19/95 

19:53:10 

1 

10 

19;58;48 

AAC 

CBROERIA  JOB09127 

10 

31  09/19/95 

19:53:04 

1 

10 

19:58:49 

ACC 

CBROERIA  JOB09130 

10 

54  09/19/95 

19:53:22 

1 

10 

19:58:50 

ACC 

CBROERIA  JOB09129 

10 

47  09/19/95 

19:53:17 

1 

10 

19:58:51 

ACC 

CBROERIA  JOB09128 

10 

40  09/19/95 

19:53:12 

1 

10 

19:58:51 

ACC 

CBROERIA  J0B09127 

10 

33  09/19/95 

19:53:06 

1 

10 

19:58:52 

TOTAL 

REPORTS  MIGRATED  TO 

SECONDARY  DISK  = 

8 

SARPATAB  DD  Statement 


The  SARPATAB  DD  statement  specifies  the  name  of  the  data  set  containing  your 
ERO  (Expanded  Retenticm  Option)  table.  This  statement  is  required  if  you  specify 
optical  retention  in  your  ERO  table  with  the  DSK2DAYS  parameter.  The  optical 
subtask  win  then  read  the  ERO  table  to  determine  migration  options. 
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Kodak  Optistar  Drivers 

CA-View  migrates  a  SYSOUT  group  to  optical  disk  when  all  of  the  following  are 
true: 

■  The  SYSOUT  group  is  archived  on  primary  disk 

■  The  SYSOUT  group  has  or  will  have  permanent  retention  status 

■  The  number  of  days  since  the  SYSOUT  group  was  archived  exceeds  the 
DSK2DAYS  initialization  parameter 

Once  migrated  to  secondary  disk  storage,  a  SYSOUT  group  continues  to  reside 
there  imtil  deleted,  or  imtil  it  expires  from  ERO  disk  retention.  ERO  disk 
retention  is  specified  by  the  DGENS,  DCOPIES,  or  DRETPD  ERO  table 
statements. 


How  CA-View  Retrieves  SYSOUT  Data  From  Optical  Disk  (Report-Level  Driver 
Only) 


If  Your  ISO  User  ID  Has  When  you  select  a  SYSOUT  group  that  shows  a  status  of  DSK2,  PRDK2,  or  PRM2 
MOUNT  Authority  (all  of  which  indicate  optical  disk  secondary  storage),  CA-View  reloads  the  entire 

SYSOUT  from  optical  disk  back  into  the  CA-View  database. 

You  can  explicitly  request  to  load  the  SYSOUT  group  back  to  the  primary  disk 
database  using  the  L  line  command  online  or  by  using  the  /LOAD  fimction  when 
executing  in  batch  using  SARBCH.  If  you  are  using  CA-View  imder  VM/CMS, 
you  must  use  the  L  line  command  or  the  /LOAD  function;  you  cannot  retrieve 
data  from  optical  disk  by  selecting  it  within  CA-View. 


It  Your  TSO  User  ID  You  must  use  the  L  line  command  online  or  the  /LOAD  function  when  executing 

Does  Not  Have  in  batch  using  SARBCH. 

MOUNT  Authority 

Once  retrieved,  the  SYSOUT  group  continues  to  reside  in  the  CA-View  database 
(as  well:  as  on  optical  disk  storage)  rmtil  the  backup  cycle  specified  by  the 
HOLDTEMP  initialization  parameter  occurs. 


You  camremove  the  SYSOUT  group  from  the  CA-View  database  before  the  next 
backup  cycle  by  explicitly  requesting  its  removal  using  the  C  line  command 
online  or  by  specifying  the  CLEAN  option  when  starting  the  CA-View  started 
task. 
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How  CA-View  Retrieves  SYSOUT  Data  From  Optical  Disk  (Page- Level  Driver  Only) 

When  you  select  a  SYSOUT  group  that  shows  a  status  of  DSK2,  PRDK2,  or  PRM2 
(all  of  which  indicate  optical  disk  secondary  storage),  CA^View  enables  you  to 
view  or  print  the  SYSOUT  group  directly.  This  is  the  preferred  method  of 
operation. 

If  necessary,  you  can:  explicitly  request  to  load  the  SYSOUT  group  back  to  the 
primary  disk  database  using  the  L  line  command  online  or  by  using  the  /LOAD 
function  when  executing  in  batch  using  SARBCH;  If  you  are  using  GA-View 
imder  VM/CMS,  you  wiiisf  use  the  L  line  command  or  the  /LOAD  function;  you 
cannot  retrieve  data  from:  optical  disk  by  selecting  it  within  CA-View. 


How  CA-View  Defines  Optical  Disk  Data  Sets 

When  migrating  SYSOUT  groups  to  optical  disk  storage,  CA-View  creates  data 
sets  automatically.  Only  one  SYSOUT  data  set  is  created  per  emulated  tape 
volume.  CA-View  continues  to  write  SYSOUT  groups  to  the  data  set  on  ^e 
emulated  tape  volume,  until  the  data  set  is  full.  Each  SYSOUT  group  is  separated 
from  the  next  by  a  tape  mark. 

When  a  SYSOUT  group  is  being  written  to  secondary  disk  and  the  end  of  volume 
is  reached,  CA-View  does  the  following: 

1.  Terminates  the  data  set 

2.  Allocates  a  new  data  set  on  the  next  emulated  tape  volume  in  the  volume 
serial  nrunber  range 

3.  Continues  writing  to  the  new  data  set 
DGB  attributes  for  the  data  set  are: 

RECFM=VB 

IiREC=32756 

BLKSIZE=32760 


Naming  Optical  Disk  Data  Sets 

CA-View  assigns  the  data  sets  names  as  follows: 

Syntax  index. SABDSK2 . Tnnnnnnn 

where: 

index  Specifies  the  high-level  index  naming  prefix  as  defined  by  the 

DSK2PARM  initialization  parameter 

nnnnnnn  Specifies  the  sequence  number  for  the  emulated  tape  data  set 
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You  specify  the  unit  name  and  volume  serial  number  range  using  the 
DSK2PARM  initialization  parameter. 


Deleting  Optical  Disk  Data  Sets 

As  part  of  its  backup  cycle,  CA-View  imcatalogs  any  emulated  tape  data  set  that 
is  no  longer  needed.  This  determination  is  based  either  on  the  global  settings 
specified  in  the  initialization  parameters  or  on  the  entries  in  the  Expanded 
Retention  Option  (ERO)  table.  See  the  section  Initialization  Parameter 
Descriptions  in  Qiapter  2,  "Initialization  Parameters,"  and  Qnapter  6,  "Expanded 
Retention  Option,"  for  more  information. 


FileTek  Drivers 


CA-View  migrates  a  SYSOUT  group  to  optical  disk  when  all  of  the  following  are 
true: 

■  The  SYSOUT  group  is  archived  on  primary  disk 

■  The  SYSOUT  group  has  or  will  have  permanent  retention  status 

■  The  number  of  days  since  the  SYSOUT  group  was  archived  exceeds  the 
DSK2DAYS  initialization  parameter 

Once  migrated  to  secondary  disk  storage,  a  SYSOUT  group  continues  to  reside 
there  rmtil  deleted,  or  until  it  expires  from  ERO  disk  retention.  ERO  disk 
retention  is  specified  by  the  DGENS,  DCOPIES,  or  DRETPD  ERO  table 
statements. 


How  CA-View  Retrieves  SYSOUT  Data  From  Optical  Disk  (Page-Level  Driver  Only) 

When  you  select  a  SYSOUT  group  that  shows  a  status  of  DSK2,  PRDK2,  or  PRM2 
(all  of  which  indicate  optical  disk  secondary  storage),  CA-View  enables  you  to 
view  or  print  the  SYSOUT  group  directly.  This  is  the  preferred  method  of 
operationi 

If  necessary,  you  can  explicitly  request  to  load  the  SYSOUT  group  back  to  the 
primary  disk  database  using  the  L  line  command  orrline  or  by  using  the  /LOAD 
function  when  executing  in  batch  using  SARBCH.  If  you  are  using  CA-View 
tmder  VM/ CMS,  you  must  use  the  L  line  command  or  the  /LOAD  function;  you 
cannot  retrieve  data  from  optical  disk  by  selecting  it  within  CA-View. 
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How  CA-View  Defines  Optical  Disk  Data  Sets 

When  migrating  SYSOUT  groups  to  optical  disk  storage,  CA-View  creates  a 
separate  file  on  the  storage  machine  for  each  SYSOUT  group  migrated.  CA-View 
writes  the  data  in  compressed  format  in  blocks  of  32760  bytes. 

Optical  Disk  Nanning  Conventions 

The  files  on  the  Storage  Machine  are  assigned  names  as  follows: 

Syntax  index.  SABDSK2 .  Gggggggg.  Ssssssass 

where: 

index  Specifies  the  high-level  index  naming  prefix  as  defined  by  the 
DSK2PARM  initialization  parameter 

gigggig  Specifies  the  generation  number  for  the  SYSOUT  group 

sssssss  Specifies  the  sequence  number  for  the  SYSOUT  group 


Deleting  Optical  Disk  Data  Sets 

As  part  of  its  backup  cycle,  CA-View  deletes  any  file  from  the  storage  machine 
that  is  no  longer  needed.  This  determination  is  based  either  on  the  global  settings 
specified  in  the  initialization  parameters  or  on  the  entries  in  the  Expanded 
Retention  Option  (ERO)  table.  See  the  section  Initialization  Parameter 
Descriptions  in  Chapter  2,  "Initialization  Parameters,"  and  Chapter  6,  "Expanded 
Retention  Option,"  for  more  information. 


OAM  Drivers 


CA-View  migrates  a  SYSOUT  group  to  optical  disk  when  all  of  the  following  are 
true: 

■  The  SYSOUT  group  is  archived  on  primary  disk. 

■  The  SYSOUT  group  has  or  will  have  permanent  retention  status. 

■  The  number  of  days  since  the  SYSOUT  group  was  archived  exceeds  the 
DSK2DAYS  initialization  parameter. 

Once  migrated  to  secondary  disk  storage,  a  SYSOUT  group  continues  to  reside 
there  im^  deleted,  or  until  it  expires  from  ERO  disk  retention.  ERO  disk 
retention  is  specified  by  the  DGENS,  DCOPIES,  or  DRETPD  ERO  table 
statements. 
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How  CA- View  Retrieves  SYSOUT  Data  From  Optical  Disk 

When  you  select  a  SYSOUT  group  that  shows  a  status  of  DSK2,  PRDK2,  or  PRM2 
(all  of  which  indicate  optical  disk  secondary  storage),  CA-View  enables  you  to 
view  or  print  the  SYSOUT  group  directly. 


If  necessary,  you  can  explicitly  request  to  load  the  SYSOUT  group  back  to  the 
primary  disk  database  using  the  L  line  command  online  or  by  using  the  /LOAD 
function  when  executing  in  batch  using  SARBCH.  If  you  are  using  CA-View 
imder  VM/CMS,  you  must  use  the  L  command  or  the  /LOAD  function;  you 
cannot  retrieve  data  from  optical  disk  by  selecting  it  within  CA-View. 


How  CA-View  Defines  Optical  Disk  Objects 

When  migrating  SYSOUT  groups  to  optical  disk  storage  (that  is,  OAM),  CA-View 
creates  one  or  more  objects  for  each  SYSOUT  group  migrated.  An  object  is  stored 
in  compressed  formatin  a  unit  of  up  to  100  logical  blocks  of  32,760  bytes  each;  all 
objects,  except  for  the  last,  are  stored  as  100  logical  blocks,  or  3,276,000  bytes. 


Naming  Optical  Disk  Objects 

The  collection  name  used  for  all’ objects  in  a  single  CA-View  database  is  as 
follows; 

Syntax  index .  SAKCOIiIi 

The  object  names  have  the  format: 
index , Gggggggg. Sasassas . Oooooooo 

where: 

index  Specifies  the  high-level  index  naming  prefix  as  defined 

by  the  DSK2PARM  initialization  parameter 

88iii8i  Specifies  the  generation  number  for  the  SYSOUT  group 

sssssss  Specifies  tine  sequence  number  for  the  emulated  tape 

data  set 

0000000  Specifies  a  sequential  number  starting  with  1,  used  to 

identify  each  member  of  a  SYSOUT  group 

User  exit  SARD05UX  can  be  coded  to  modify  the  collection  names.  See  the 
comments  in  the  SARD05UX  source  code  for  specifications. 


1 0-20  CA-View  System  Reference  Guide 


IBM  DASD  Emulation  Optical  Drivers 


Deleting  Optical  Disk  Objects 

As  part  of  its  backup  cycle,  CA-View  deletes  any  objects  that  are  no  longer 
needed.  This  determination  is  based  either  on  the  global  settings  specified  in  the 
initialization  parameters  or  on  the  entries  m  the  Expanded  Retention  Option 
(ERO)  table.  See  Chapter  2,  "Initialization  Parameters,"  and  Chapter  6, 
"Expanded  Retention  Option,"  for  more  information. 


IBM  DASD  Emulation  Optical  Drivers 

CA-View  migrates  a  SYSOUT  group  to  optical  disk  when  all  of  the  following  are 
true: 

■  The  SYSOUT  group  is  archived  on  primary  disk 

■  The  SYSOUT  group  has  or  will  have  permanent  retention  status 

■  The  number  of  days  since  the  SYSOUT  group  was  archived  exceeds  the 
DSK2DAYS  initialization  parameter 

Once  migrated  to  secondary  disk  storage,  a  SYSOUT  group  continues  to  reside 
there  imtil  deleted,  or  tmtil  it  expires  from  ERO  disk  retention.  ERO  disk 
retention  is  specified  by  the  DGENS,  DCOPIES,  or  DRETPD  ERO  table 
/  statements. 

O' 


How  CA-View  Retrieves  SYSOUT  Data  From  Optical  Disk 

When  you  select  a  SYSOUT  group  that  shows  a  status  of  DSK2,  PRDK2,  or  PRM2 
(aU  of  which  indicate  optical  disk  secondary  storage),  CA-View  enables  you  to 
view  or  print  the  SYSOUT  group  directly. 

If  necessary,  you  can  explicMy  request  to  load  the  SYSOUT  group  back  to  the 
primary  disk  database  using  the  L  line  command  online  or  by  using  the  /LOAD 
function  when  executing  in  batch  using  SARBCH.  H  you  are  using  CA-View 
imder  VM/ CMS,  you  must  use  the  L  command  or  the  /LOAD  function;  you 
cannot  retrieve  data  from  optical  disk  by  selecting  it  within  CA-View. 


How  CA-View  Defines  Optical  Disk  Data  Sets 

When  migrating  SYSOUT  groups  to  optical  disk  storage,  CA-View  creates  a 
separate  data  set  for  each  SYSOUT  group  migrated.  The  data  sets  are  allocated 
using  the  xmit  name  specified  in  the  DSK2P ARM  initialization  parameter. 
CA-View  writes  the  data  in  compressed  format  in  blocks,  using  the  blocksize 
specified  in  the  DSK2PARM  parameter. 
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Optical  Disk  Naming  Conventions 

The  data  sets  are  assigned  names  in  the  form: 
index .  SAKDSK2 .  Gggggggg.  Sssaassss 

where: 

index  Specifies  the  high-level  index  naming  prefix  as  defined 

by  the  DSK2PARM  initialization  parameter 

SSiiSSS  Specifies  the  generation  number  for  the  SYSOUT  group 

sssssss  Specifies  the  sequence  number  for  the  emulated  tape  data 

set 


Deleting  Optical  Disk  Data  Sets 

As  part  of  its  backup  cycle,  GA-View  deletes  any  data  set  that  is  no  longer 
needed.  This  determination  is  based  either  on  the  global  settings  specified  in  the 
initialization  parameters  or  on  the  entries  in  the  Expanded  Retention  Option 
(ERO)  table.  See  the  section  Initialization  Parameter  Descriptions  ini  Chapter  2, 
"Initialization  Parameters,"  and  Chapter  6,  "Expanded  Retention  Option,"  for 
more  information. 


Optical  Disk  Database  Maintenance 

The  MERGE  and  UNLOAD  fimctions  of  the  CA-View  database  maintenance 
utility  (SARDBASE)  contain  parameters  to  support  optical  disk  storage.  See  the 
section  Database  Maintenance  with  SARDBASE  in  Chapter  7,  "Database 
Utilities,"  for  additional  information  about  these  functions. 
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UNLOAD  Control  Statement 

The  UNLOAD  control  statement  allows  for  unloading  the  SYSOUT  data  for 
SYSOUT  groups  archived  to  secondary  disk  storage. 

Syntax  UNLOAD  [second |nosecond] 

where: 

SECOND  Unload  the  SYSOUT  data  for  SYSOUT  groups  archived 
to  secondary  disk  storage 

NOSECOND  Do  not  unload  the  SYSOUT  data  for  SYSOUT  groups 

archived  to  secondary  disk  storage 

The  SECOND/NOSECOND  parameter  has  a  default  value  of  NOSECOND. 
Specifying  SECOND  can  substantially  increase  the  time  required  to  perform  the 
UNLOAD  function; 


Whether  or  not  you  specify  SECOND  when  utvloading,  the  LOAD  function  never 
reloads  the  SYSOUT  data  for  SYSOUT  groups  archived  to  secondary  disk 
storage.  The  LOAD  function  merely  transfers  ownership  of  the  secondary  disk 
storage  that  is  already  archived. 

You  must  specify  SECOND  when  unloading  the  databases  if  you  are  going  to  use 
the  MERGE  function,  because  the  MERGE  function  always  reloads  the  SYSOUT 
data,  either  to  primary  cr  secondary  disk. 


Only  MERGE  Moves  Optical  Disk  Data 

The  MERGE  function  should  be  used  for  reloading  the  actual  SYSOUT  data  from 
secondary  disk  storage.  The  COPY  and  LOAD  functions  copy  the  index 
information  about  the  SYSOUT  groups  on  secondary  disk  storage.  In  other 
words,  COPY  and  LOAD  merely  transfer  ownership  of  the  secondary  disk 
storage  data  that  is  already  archived,  while  the  MERGE  actually  reloads  the  data 
to  another  optical  disk  data  set. 

In  addition  to  merging  multiple  databases  together,  you  can  use  the  merge 
function  to  replace  one  type  of  secondary  disk  device  with  another,  to  consolidate 
the  archived  secondary  disk  storage,  and  to  replace  secondary  disk  storage  with 
primary  disk. 
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MERGE  Statement  Prerequisite 

When  performing  a  MERGE  function  with  an  input  database  that  contains  any 
SYSOUT  groups  archived  to  secondary  disk  storage,  the  contents  of  the 
;  secondary  disk  SYSOUT  groups  must  have  been  unloaded  with  SECOND 
specified  on  the  UNLOAD  control  statement  (UNLOAD  Control  Statement  later 
in  this  chapter).  The  MERGE  function  will  then  reload  the  SYSOUT  groups  based 
upon  the  secondary  disk  operands  on  the  MERGE  command. 

MERGE  Control  Statement 

The  syntax  of  the  MERGE  control  statement  is  as  follows: 

Syntax  HERGE  tape-index  driver  parameters 

where: 

tape-index  Specifies  the  high-level  naming  prefix  to  be  set  for  the  TAPEIDX 
initialization  parameter 

If  omitted,  TAPEIDX  is  set  to  the  name  of  the  output  database. 

driver  Specifies  the  required  name  of  the  secondary  disk  storage  driver 

This  name  must  be  the  same  as  the  one  specified  by  the 
DSK2DRVR  initialization  parameter.  Specify  SARD2D0x  for  the 
optical  disk  driver  you  have  purchased.  Replace  the  x  with  the 
driver  number  described  in  Driver  Names  and  Types  earlier  in  this 
chapter. 

parameters  Specifies  the  required  unit  name  and  volume  serial  number  range 

for  the  secondary  disk  storage  driver  as  defined  by  the 
DSK2PARM  initialization  parameter. 

The  parameters  are  required  when  you  specify  a  driver  name. 

■  For  the  Kodak  Optistar  Report-Level  Driver,  the  format  of  this 
operand  is: 

iinit/volserl/VoXser2 

For  an  explanation  of  these  identifiers,  see  the  section 
DSIC2PARM:  Kodak  Optistar  Report-Level  Driver  earlier  in 
this  chapter. 

■  For  the  Kodak  Optistar  Page-Level  Driver,  the  format  of  this 
operand  is: 

unit/volserl/volser2/8sid 
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For  an  explanation  of  these  identifiers,  see  the  section 
DSK2PARM:  IBM  Page-Level  Driver  for  Models  131, 132, 133 
earlier  in  this  chapter. 

■  For  the  IBM  D ASD  Emulation  Optical  Driver,  the  format  of 
this  operand  is: 

isdaxc/tmi  t  /blksize 

For  an  explanation  of  these  identifiers,  see  the  section 
DSK2PARM:  IBM  Page  Level  Driver  for  Models  131, 132, 133 
earlier  intiiis  chapter. 


MERGE  Command  Operand  Restrictions 

Since  the  operands  for  the  MERGE  command  are  positional,  specify  an  asterisk  to 
indicate  the  omission  of  the  tape-index  operand  when  you  code  the  driver  and 
parameters  operands. 

To  prevent  conflicts  with  any  existing  archive  tapes,  MERGE  requires  that  the 
high-level  naming  prefix  for  tapes  be  different  from  those  for  any  other  tapes 
defined  in  the  input  databases. 


To  Reload  From  Optical  Disk  to  the  CA-View  Database 

If  you  omit  the  driver  operand,  you  must  also  omit  the  parameters  operand.  When 
the  driver  and  parameters  operands  are  omitted,  at  MERGE  time  any  SYSOUT 
groups  unloaded  from  the  optical  disk  are  reloaded  to  the  primary  disk  CA-View 
database. 
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In  This  Chapter 

This  chapter  discusses  the  user  exits  that  allow  you  to  customize  CA-View. 

CA-View  user  exits  allow  you  to  customize  the  product  to  fit  your  requirements. 
The  code  for  the  exits  as  well  as  the  mapping  macros  for  the  CA-View  control 
blocks  are  distributed  in  VIEW.SOURCE.  The  exits  must  be  link-edited  with 
authorization  code  1  and  placed  in  the  library  containing  the  CA-View  load 
modules. 


User  Exit 

Function 

E22CICUX 

QCS/ cross-memory  connection  HD 

E22zxxUX 

Cross-memory  connection  ID 

SAR$xxxx 

Device  specific 

SARACFUX 

ACIF  archival  task  exit 

SARACTUX 

Job  accounting 

SARARAUX 

Automatic  report  archival 

SARATHUX 

Authorization 

SARBKTUX 

Backup  cycle 

SARDSTUX 

Reprint  destinations 

SARDVSUX 

DVS  Xerox  archival  task  exit 

SAREASUX 

EA0  for  tape  and  robotics  exit 

SARJS2UX 

JES  control  block  mapping 

SARMFPUX 

Microfiche 

SAROMSUX 

Online  management  system 

SARPACUX 

SARPAC  tape  consolidation 

SARPRFUX 

User  profile 

SARPRTUX 

Banner  page 

Continued 
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E22ClCUX-CICS/Cross-Memory  Connect  ID  Exit 


Continued 


User  Exit 

Function 

SARSEGUX 

Security 

SARSMFUX 

SMF  processing 

SARSPFUX 

Selection  list  formatting 

SARSRQUX 

Selection  request 

SARSTGUX 

Archival  task 

SARSUBUX 

Job  submission 

SARTPOUX 

Tape  creationvolser  exit 

SARUSxUX 

User  ID  determination 

SARXGTUX 

Exceptional  condition  checking 

E22CICUX-CICS/Cross-Memory  Connect  ID  Exit 


Register  Contents: 
Entry 

Other  Security  Exits 


The  E22CICUX  exit  determines  the  GIGS/  cross-memory  connection  ID  used  for 
online  retrieval;  The  exit  is  called  by  the  GIGS/cross-memory  features  to  supply 
the  connection  ID  whenever  the  feature  is  initially  invoked  by  a  user. 

This  exit  follows  standard  GIGS  command-level  conventions,  and  is  a  standard 
GIGS  application. 

This  exit  can  be  used  in  conjunction  with  the  SARUSXUX  and  SARSEGUX  user 
exits.  For  more  information,  see  ttie  descriptions  of  these  exits,  and  the  Security 
section  in  Ghapter  3,  "Gonfiguring  GA-View." 


E22xxxUX-Cross-Memory  Connect  ID  Exits 

The  'E22xxx\JX  exits  can  determine  the  cross-memory  connection  ID  used  for 
online  retrieval.  The  exits  are; 


E22SPFUX 

E22TSOUX 

E22ROSUX 

E22IMSUX 


For  ISPF/cross-memory  online  retrieval 
For  TSO/cross-memory  online  retrieval 
For  GA-Roscoe/ cross-memory  online  retrieval 
For  IMS/ cross-memory  online  retrieval 
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The  exits  are  called  by  the  cross-memory  features  to  supply  the  connection  IID 
whenever  the  feature  is  initially  invoked  by  a  user. 

Register  Contents:  The  significant  contents  of  Ihe  general  registers  on  entry  are: 

Entry 

Reg  1  Address  of  the  parameter  list 

Rfeg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

•^®^urn  contained  on  entry,  and  the  exit  must  place  a  return  code  in  register  15.  The 

return  codes  are: 


0  The  logon  process  is  continued 
4  The  logon  process  is  aborted 

Other  Security  Exits  This  exit  can  be  used  m  conjimction  with  the  SARUSXUX  and  SARSEGUX  user 

exits.  For  more  information;  see  the  descriptions  of  these  exits,  and  the  Security 
section  in  Chapter  3,  "Configuring  CA-View." 

u 

SAR$xxxx-Device-Specific  Exit 

SAR$xxs:x  provides  any  configuring  information  required  by  "smart"  devices  that 
have  multiple  operating  and/ or  emulating  modes.  An  opportunity  is  provided  to 
send  such  special  configuring  data  to  the  device,  both  before  and  after  the  OPEN, 
as  well!  as  before  and  after  the  CLOSE. 

The  name  of  this  exit  is  user-selectable,  except  that  it  must  begin  with  SAR$. 
Sample  Exit  The  sample  exit  provided  must  be  tailored  to  meet  your  site  requirements. 
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SAR$xxxx-Device-Specif  ic  Exit 


Register  Contents: 
Entry 


Register  Contents: 
Return 


Caiiing  Sequence 


CA-Spool 


A  parameter  list  is  passed  to  the  exit  with  the  addresses  of  the  master  control 
record,  the  group  control  record,  the  open  print  DCB  and  the  SYSOUT 
destination,  forms  name,  and  class.  The  contents  of  the  significant  general 
registers  on  entry  to  the  exit  are: 

Reg  0  Contains  fimction  codes  as  follows: 

X'OO'  Called  before  OPEN 

X'04'  Called  after  OPEN 

X'OC'  Called  before  CLOSE 

X'lO'  CaUed  after  CLOSE 

Reg  1  Address  of  the  print  parameter  list  (mapped  by  SARPPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry.  The  exit  must  be  link-edited  with  authorization  code  1  and 
placed  in  the  library  containing  the  CA-View  load  modules. 

Calling  sequence  with  regard  to  I/O  and  SARPRTUX  is  as  follows: 

1.  This  exit-Fimction  0  (before  OPEN) 

2.  OPEN 

3.  This  exit-Function  4  (after  OPEN) 

4.  SARPRTUX-Fimction  0  (start  of  group) 

5.  PUTS 

6.  SARPRTUX-Fimction  4  (end  of  group) 

7.  This  exit-Function  12  (before  CLOSE) 

8.  CLOSE 

9.  This  exit-Function  16  (after  CLOSE) 

Many  CA-Spool  parameters  are  kept  near  the  end  of  the  SARPPL  in  fields  labeled 
'PPLCM...'. 


O' 


J 
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SARACFUX^ACIF  Archival  Task  Exit 


SARACFUX-ACIF  Archival  Task  Exit 

SARACFUX  is  invoked  by  a  SARPSS  archival  started  task  at  the  following  times: 

■  When  SARFSS  begins  processing  a  SYSOIiJT  data  set 

■  As  SARFSS  gets  each  SYSOUT  record  in  the  data  set 

■  Before  each  AFP  record  is  put  into  the  CA-View  database 

■  When  SARFSS  completes  processing  of  the  SYSOUT  data  set 

The  exit  can  be  used  to  modify  report  attributes  and  to  analyze  the  records  for 
exceptional  conditions.  The  report  ID,  generation  number,  sequence  munber,  and 
archival  date  cannot  be  modified. 


Standard  Exit 


Register  Contents: 
Entry 


Whenever  an  exceptional  condition  is  identified,  this  exit  can  do  either  or  both  of 
the  following: 

■  Set  a  short  exception  message  in  the  group  control  record  (GCRXGODE), 
which  is  displayed  in  the  SYSOUT  selection  list  used  for  retrieval 

■  Change  or  set  the  user  accoimting  data  in  the  group  control  record 
(GCRUSER) 

This  exit  must  be  link-edited  wiih  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules. 

The  standard  exit  that  is  supplied  with  CA-View  is  a  dummy  routine  which 
merely  returns  control  to  the  caller. 

A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 
control  record,  the  group  control  record,  and  the  SYSOUT  record,  and  the  length 
of  the  SYSOUT  record. 
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SARACTUX-Job  Accounting  Exit 


Register  Contents: 
Return 


SARACTUX 


standard  Exit 


The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  0  Contains  entry  codes  as  follows: 

0  Specifies  that  a  new  SYSOUT  data  set  has  been  selected^ 

The  GCR  for  the  data  set  can  be  modified  as  desired,  with  the 
exception  of  report  ID,  generation  number,  sequence  number, 
and  archival  date. 

4  Specifies  that  an  AFP-style  record  (boimd  for  the  CA-View 

database)  is  being  passed  for  exceptional  condition  analysis 

8  Specifies  the  end  of  the  current  SYSOUT  group 

12  Specifies  that  a  SYSOUT  record  from  JES  (bound  for  AFP 

processmg)  is  being  passed  for  exceptional  condition  analysis 

These  records  are  more  legible  than  the  AFP-style  records  passed 
with  entry  code  4. 

Reg  1  Address  of  the  security  parameter  list  (mapped  by  macro  SARSPT) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 

On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry. 


i 


Job  Accounting  Exit 

SARACTUX  extracts  accounting  data  for  a  job  or  time-sharing  session.  The  exit  is 
passed  the  type-20  SMF  record  for  the  job  or  time-sharing  session  and  returns  20 
bytes  of  accounting  data.  When  subsequently  archiving  SYSOUT  for  the  same  job 
or  time-sharing  session,  the  ajxhival  task  copies  these  20  bytes  of  data  to  the  user 
accounting  data  field  in  the  group  control  record  for  the  SYSOUT  (GCRUSER). 

The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules.  In  addition,  the  exit  must  not  contain  any 
relocatable  address  constants,  for  example,  A  (relocatable  address)  or  V 
(relocatable  address). 

The  standard  exit  that  is  supplied  with  CA-View  extracts  the  first  and  second 
fields  from  the  accounting  field  of  the  JOB  statement  The  two  fields  are  returned 
as  bytes  1  to  10  and  11  to  20,  respectively. 
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SARARAUX-Automatic  Report  Archival  Exit 


Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are- 

Entry 


RegO 

Regl 
Reg  13 
Reg  14 
Reg  15 


Address  of  file  20-byte  area  into  which  the  exit  is  to  retum  the 
accounting  data 

Address  of  the  type-2G  SMF  record 

Address  of  a  standard>  72-byte  register  save  area 

Return  address 

Entry  point  address 


Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry. 


SARARAUX-Automatic  Report  Archival  Exit 


The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules.  In  addition,  the  exit  must  not  contain  any 
relocatable  address  constants,  for  example,  A  (relocatable  address)  or  V 
(relocatable  address). 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  allows  the  job  and  SYSOUT 

classes  specified  in  the  FARM  field  to  SARXTD  to  determine  whether  to 
automatically  archive  the  SYSOUT  data  sets. 

Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Entry 

Reg  1  Address  of  the  automatic  report  archival  exit  parameter  list 
(mapped  by  macro  SARAPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit>  registers  2  to  13  must  contain  the  same  contents  as  they 

•^®'*'urn  contained  on  entry,  and  the  exit  must  place  a  return  code  m  register  15. 


SARARAUX  is  given  control  by  the  automatic  report  archival  feature  of  CA-View 
extensions  to  determine  whether  or  not  a  copy  of  a  SYSOUT  data  set  is  to  be 
produced  for  archival  purposes.  In  addition,  the  exit  can  be  used  to  modify  the 
SYSOUT  attributes  used  to  create  the  archival  copy  of  the  data  set  and  to  assign  a 
SYSOUT  ID  to  it. 
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SARATHUX-Authorization  Exit 


The  return  codes  are: 

0  Use  the  job  and  SYSOUT  classes  specified  in  the  PAiavl  field  to  SARXTD 
to  determine  whether  to  automatically  archive  the  SYSOUT  data  set 

4  Automatically  archive  the  SYSOUT  data  set;  unconditional 

8  Do  not  automatically  archive  the  SYSOUT  data  set;  unconditional' 


SARATHUX-Authorization  Exit 


SARATPiUX  determines  whether  a  specified  job  is  authorized  to  perform  high- 
level  database  functions.  To  do  this,  CA-View  passes  the  request  type  and  request 
data  requiring  authorization  to  SARATHUX.  It  returns  a  return  code  to  the  rallpr 
that  indicates  the  authorization  condition.  The  standard  exit  that  is  supplied  with 
CA-View  authorizes  all  jobs  to  perform  all  functions. 

The  exit  must  be  linkr-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  module;  it  will  be  invoked  in  31-bit  mode  and  must 
maintain  31-bit  compatibility  in  an  MVS/XA  and  MVS/ESA  environment; 

Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Entry 

Reg  0  Address  of  the  8-byte  request  type 

Reg  1  Address  of  the  request  data 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

Authorization  Request  The  following  are  the  authorization  request  types,  and  their  descriptions: 

Types  _ 


Request 

Type 

Invoking 

Program 

Authorization  Description 

ADDDS 

SARDBASE 

Creates  data  sets  for  a  database 

ADDLOCK 

SARDBASE 

Creates  lock  data  set  for  a  database 

BATCH 

SARBCH 

Performs  requests  via  the  SARBCH  utility 

COPY 

SARDBASE 

Copies  a  database 

DELETE 

SAI®BASE 

Deletes  a  database 

Continued 
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SARATHUX-Authorization  Exit 


Data  Format  of 
Authorization  Request 
Types 


Continued 


Request 

Type 

Invoking 

Progrann 

Authorization  Description 

DELLOCK 

SARDBASE 

Deletes  lock  data  set  for  a  database 

IDXOUT 

SARDBASE 

Offloads  database  index 

INIT 

SARINET 

Updates  or  displays  CA-View  initialization 
parameters 

LOAD 

SARDBASE 

Loads  a  database  from  a  sequential  previously 
unloaded  file 

MERGE 

SARDBASE 

Merges  databases 

OLOAD 

SARDBASE 

Loads  online  panels  and  messages 

RENAME 

SARDBASE 

Renames  a  database 

REORG 

SARDBASE 

Reorganizes  a  database 

RESTORE 

SARDBASE 

Restores  a  database 

STATUS 

SARDBASE 

Obtains  database  statistics 

UNLOAD 

SARDBASE 

Unloads  a  database 

UNLOCK 

SARDBASE 

Unlocks  a  database 

VERIFY 

SARDBASE 

Verifies  and  recovers  a  corrupted  database 

VERSION 

SARDBASE 

Resets  the  database  to  a  specific  version 

The  format  of  the  request  type  data,  referenced  by  general  register  1,  for  the 
related  request  types  is  as  follows: 

Request  Type 

Request  Data 

ADDDS 

35-byte  parameter: 

Bytes  01-08 

Unit  name 

Bytes  09-14 

Volume  serial 

Bytes  15-16 

Binary  number  of  cylinders 

Bytes  17-18 

Binary  database  blocksize 

Bytes  19-35 

High-level  database  index  name 

Continued 
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SARATHUX-Authorization  Exit 


Continued 


Request  Type  Request  Date 


ADDLOCK 

35-byte  parameter: 

Bytes  01-08  Unit  name 

Bytes  09-14  Volume  serial 

Bytes  15-18  Not  used 

Bytes  19-35  High-level  database  index  name 

BATCH 

17-byte  highdevel  database  index  name 

COPY 

34-byte  parameter: 

Bytes  01-17  High-level  database  index  name  of  receiving 

database 

Bytes  18-34  High-level  database  index  name  of  sending 

database 

DELLOCK 

17-byte  high-level  database  index  name 

DELETE 

17-byte  high-level  database  index  name 

IDXOUT 

17-byte  high-level  database  index  name 

INTT 

17-byte  high-level  database  index  name 

LOAD 

17-byte  high-level  database  index  name 

MERGE 

102-byte  parameter: 

Bytes  High-level  database  index  name  of  merge  database 

01-17 

Bytes  New  tape  high-level  database  index  name  for 

18-34  database 

Bytes  Name  of  secondary  disk  driver 

35-42 

Bytes  Parameter  data  for  secondary  disk  driver 

43-102 

OLOAD 

17-byte  high-level  database  index  name 

RENAME 

34-byte  parameter: 

Bytes  High-level  database  index  name  of  database  to  be 

01-17  renamed 

Bytes  High-level  database  index  name  to  which  the  database 

18-34  will  be  renamed 

REORG 

17-byte  high-level  database  index  name 

Continued 
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SARBKTUX-Bdckup  Cycle  Exit 


V  _  J  Continued 


Request  Type 

Request  Data 

RESTORE 

17-byte  high-level  database  index  name 

STATUS 

17-byte  high-level  database  index  name 

UNLOAD 

17-byte  high-level  database  index  name 

UNLOCK 

17-byte  high-level  database  index  name 

VERIFY 

17-byte  high-level  database  index  name 

VERSION 

17-byte  high-level  database  index  name 

Register  Contents:  On  retum  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry  to  the  exit.  The  exit  must  also  place  a  return  code  in  register 

15.  The  return  codes  are  as  follows: 

0  The  job  is  authorized  to  perform  the  requested  function. 

4  The  job  is  not  authorized  to  perform  the  requested  fimction. 


SARBKTUX-Backup  Cycle  Exit 

SARBKTUX  is  invoked  by  the  CA-View  backup  cycle  before  copying  a  report  to 
tape.  The  exit  can  be  used  to  override  the  decision  to  backup  a  report  to  tape. 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  is  a  dummy  routine  that  merely 

returns  control  to  the  caller. 

Register  Contents:  A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  group 

control  record  (mapped  by  DSECT  SARGCR).  The  contents  of  the  significant 
general  registers  on  entry  to  the  exit  are: 


Reg  1  Address  of  the  parameter  list 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry. 
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SARDSTUX-Destination  Exit 


Examples 

SARDSTUX 


standard  Exit 

Register  Contents; 
Entry 


Register  15  must  be  returned  as  follows: 

0  The  SYSOUT  group  will  be  backed  up  to  tape 

Other  The  SYSOUT  group  will  NOT  be  backed  up  to  tape 

■  You  do  not  wish  to  back  up  reports  that  were  rerun;  with  condition  codes 
greater  than  8. 

The  exit  would  query  GCRXGODE. 

■  You  do  not  wish  to  back  up  GIGS  started  task  output. 

The  exit  would  query  GGRJNAM  or  GGRID. 


Destination  Exit 

SARDSTUX  determines  whether  a  user  or  job  is  authorized  to  invoke  an  output 
(print)  command  to  a  specified  destination. 

A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 
control  record,  the  group  control  record,  the  job  name,  the  user  ID,  the  RAGF 
user  ID,  the  mode  of  the  caller,  and  the  destination.  The  exit  must  be  link-edited 
with  authorization  code  1  and  placed  in  the  library  containing  the  GA-View  load 
modules. 

The  standard  exit  that  is  supplied  with  GA-View  aUbws  all  output  to  be 
generated  at  any  destination. 

The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  0  Address  of  the  security  parameter  list  (mapped  by  macro  SARDPL) 

Reg  1  Address  of  the  request  data 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 
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SARDVSUX-DVS  Xerox  Archival  Task  Exit 


Register  Contents: 
Return 


SARDVSUX 


standard  Exit 


Register  Contents: 
Entry 


On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry,  and  Ihe  exit  must  place  a  return  code  in  register  15.  The 
return  codes  are: 


0  The  user /job  is  authorized  to  print  this  output. 

4  The  user /job  is  not  authorized  to  print  this  output. 

DVS  Xerox  Archival  Task  Exit 

SARDVSUX  is  invoked  by  a  SARFSS  archival  started  task  at  the  following  times: 

■  When  it  begins  processing  a  SYSOUT  data  set 

■  As  it  gets  each  SYSOUT  record  from  JES 

■  Before  each  DVS-style  record  is  put  into  the  CA-View  database 

■  When  it  completes  processing  of  the  SYSOUT  data  set 

The  exit  can  be  used  to  modify  report  attributes  and  to  analyze  the  records  for 
exceptional  conditions.  The  report  ID,  generation  number,  sequence  number,  and 
archival  date  cannot  be  modified. 

Whenever  an  exceptional  condition  is  identified,  the  exit  can  do  either  or  both  of 
the  following: 

■  Set  a  short  exception  message  in  the  group  control  record  (GCRXCODE) 
which  is  displayed  m  the  SYSOUT  selection  list  used  for  retrieval. 

■  Qiange  or  set  the  user  accounting  data  in  the  group  control  record 
(GCRUSER). 

The  exit  must  be  link-edited  witii  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules. 

The  standard  exit  that  is  supplied  with  CA-View  is  a  dummy  routine  which 
merely  returns  control  to  the  callfer. 

A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 
control  record,  the  group  control  record,  and  the  SYSOUT  record,  and  the  length 
of  the  SYSOUT  record. 


SAREASUX-EAO  for  Tape  and  Robotics  Exit 


Register  Contents: 
Return 


SAREASUX 


standard  Exit 


The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  0  Contains  the  entry  code: 

0  Specifies  that  a  new  SYSOUT  data  set  has  been  selected 

The  GCR  for  the  data  set  can  be  modified  as  desired,  with  the 
exception  of  report  ID,  generation  ntimber,  sequence  number, 
and  archival  date. 

4  Specifies  that  a  DVS-style  record  (boimd  for  the  CA-View 
database)  is  being  passed  for  exceptional  condition  analysis 

8  Specifies  the  end  of  the  current  SYSOUT  group 

12  Specifies  that  a  SYSOUT  record  from  JES  (bound  for  DVS 

processing)  is  being  passed  for  exceptional  condition  analysis 

When  processing  LCDS  data,  these  records  may  be  more  legible 
than  the  DVS-style  records  passed  with  entry  code  4; 

Reg  1  Address  of  the  security  parameter  list  (mapped  by  macro  SARSPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry. 


I 


EAO  for  Tape  and  Robotics  Exit 

SAREASUX  is  available  for  customizing  the  expanded  access  option  for  tape  and 
robotics,  most  commonly  for  use  with  tape-emulation  optical.  It  is  invoked  by  the 
started  task  running  a  program  called  SAREAS.  SAREASUX  is  called  to 
determine  whether  a  request  for  a  given  volume  should  be  handled  by  the 
processing  thread  which  is  currently  handling  a  different  given  volume.  It  is  most 
commonly  used  to  unprove  performance  with  tape-emulation  optical  devices, 
where  it  allows  the  same  processing  thread  to  handle  requests  for  all  logical 
volumes  on  the  same  optical  platter. 

The  standard  exit  that  is  supplied  with  CA-View  is  a  dummy  routine  which 
merely  returns  4  to  indicate  that  requests  for  different  volumes  are  not  to  be 
processed  together. 
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SAREASUX-EAO  for  Tape  and  Robotics  Exit 


Register  Contents: 
Entry 


Register  Contents; 
Return 


A  parameter  list  is  passed  to  the  exit  containmg  the  addresses  of  the  master 
control  record,  the  group  control  record,  and  the  SYSOUT  record,  and  the  lengdi 
of  the  SYSOUT  record.  The  contents  of  the  significant  general  registers  on  entry 
to  the  exit  are: 


Reg  1  Address  of  tire  parameter  list 

The  first  word  contains  one  of  the  following  entry  codes: 

0  Initialization 
4  Termination 

8  Comparison  of  current  thread  volume  with  new  volume 

12  Comparison  of  current  thread  volume  with  volume  to  service 
next 

The  next  4  words  in  the  parameter  list  are  orrly  valid  for  entry  codes  8 
and  12: 

Word  2  Address  of  data  set  name  on  thread 
Word  3  Address  of  volume  name  on  thread 
Word  4  Address  of  data  set  name  for  new  request  or  to  service  next 
Word  5  Address  of  volume  name  for  new  request  or  to  service  next 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 
Reg  15  Entry  point  address 

On  return  from  the  exit,  registers  0  tol3  must  contain  the  same  contents  as  they 
contained  on  entry.  If  register  15  is  non-zero  on  return  from  initialization, 
SAREAS  fails.  If  register  15  is  nomzero  on  return  from  entry  code  8,  the  new 
request  is  NOT  to  be  handled  by  the  thread  handling  the  given  volume.  If 
register  15  is  non-zero  on  return  from  entry  code  12,  the  given  volume  (word  5  of 
the  parameter  list)  is  not  to  be  serviced  next. 


SARJS2UX-Control  Block  Mapping  Exit 


SARJS2UX-Control  Block  Mapping  Exit 

SARJS211JX  is  invoked  by  the  archival  task  when  it  needs  to  extract  print 
attributes  for  a  JES2  SYSOUT  data  set  and  the  initializationi  parameter  JES2LVL=0 
is  specified.  The  user  exit  obtains  the  address  and  offsets  within  JES2. 


There  is  no  load  module  supplied  for  this  exit,  only  source  code.  To  use  the  exit, 
it  must  be  assembled  as  is,  witih  the  installation's  source  library.  The  exit  must  be 
link-edited  with  authorization  code  1  and  placed  in  the  library  containing  the 
CA-View  load  modules.  After  link-editing  the  exit>  the  SARIMT  program  should 
be  executed  with  the  initialization  option  JES2LVL=0. 

In  general,  a  value  other  than  JES21,VL=0  should  be  specified  and  this  user  exit 
should  not  be  used;  however,  if  the  standard  PDE»Bs  supplied  by  IBM  have  been 
changed,  this  user  exit  is  available. 


SARMFPUX-Microfiche  Exit 

SARMFPUX  performs  the  following  functions  for  the  microfiche  format  program: 

■  Determines  whether  a  SYSOUT  group  is  to  be  microfiched 

■  Formats  and  outputs  the  SYSOUT  data 

■  Updates  the  group  control  record  with  changes 

A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 
control  record,  the  group  control  record,  the  open  DCB  for  the  output  file,  and 
the  SYSOUT  record. 


The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules. 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  writes  all  SYSOUT  for  the 

generation  sequentially  to  file  output  file  and  inserts  a  special  separator  record 
before  each  SYSOUT  group.  Data  from  the  separator  record  can  be  used  to 
identify  the  job,  create  an  index  for  the  fiche,  or  produce  humanrreadable  titles. 
See  the  section  Microfiche  Processing  with  SARMFP  in  Chapter  3,  "Configuring 
CA-View,"  for  a  description  of  the  separator  record. 


11-16  CA-View  System  Reference  Guide 


SAROMSUX-Online  Management  System  Exit 


Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Entry 

RegO  Contains  entry  codes  as  follows: 

0  Specifies  that  a  new  SYSOUT  group  is  being  processed 

The  exit  indicates  whether  to  microfiche  the  group  via  a  return 
code. 

4  Specifies  that  a  data  record  is  being  passed  to  the  exit 

8  Specifies  the  end  of  data  for  SYSOUT  group 
12  Specifies  final  call,  all  SYSOUT  has  been  processed 
Reg  1  Address  of  the  microfiche  parameter  list  (mapped  by  macro  SARMPL) 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 
Reg  15  Entry  point  address 

Register  Contents;  On  return  from  the  exit>  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry,  and  ihe  exit  must  place  a  return  code  in  register  15.  The 

return  codes  are: 


Function 

Return  Code 

Description 

0 

0 

Microfiche  the  SYSOUT  group 

4 

Do  not  microfiche  the  SYSOUT  group 

4 

0 

Obtain  the  next  SYSOUT  record  and  call  the  exit 
again  with  it 

4 

Terminate  processing  of  the  SYSOUT  group 

8 

- 

Return  codes  are  not  checked 

12 

- 

Return  codes  are  not  checked 

SAROMSUX-Onllne  Manag^nent  System  Exit 

The  online  management  system  Exit,  SAROMSUX,  is  invoked  prior  to  calling 
display  services.  It  allow's  you  to  examine  and/ or  change  the  (DhUne  Exit  Block 
(OXB)  and  its  contents. 

SAROMSUX  can  change  a  panel  to  invoke  an  alternate  panel. 
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SARPACUX-Permanent  Archival  Consolidation  Exit 


Online  Exit  Block 
Contents 


Register  Contents: 
Entry 


SARPACUX 


standard  Exit 


Register  Contents: 
Entry 


The  address  of  the  OXB  is  passed  to  SAROMSUX  so  that  it  can  identify  the 
display  fimction  and  panel.  The  contents  of  the  OXB  are  as  follows: 

■  UPL  address 

■  Online  panel  name 

■  Address  and  exit  communication  area 

■  Work  area 

■  Length  of  OXB 

The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  1  Address  of  the  online  exit  block  (mapped  by  macro  SAROXB) 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 


Permanent  Archival  Consolidation  Exit 


SARPACUX  can  override  SARPAC's  internal  decision  that  detemnines  whether 
or  not  to  consolidate  a  tape. 

A  parameter  list  is  passed  to  the  exit  containing  usage  information  about  the  tape. 
The  exit  can  examine  the  information  and,  based  upon  its  own  criteria,  make  a 
decision  as  to  whether  or  not  the  tape  should  be  consolidated. 

The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules. 

The  standard  exit  supplied  with  the  CA-View  returns  without  overriding 
SARPAC's  internal  decision. 

The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  1  Address  of  the  tape  specification  parameter  list  (mapped  by  SARTPL) 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 
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SARPRFUX-User  Profile  Exit 


Register  Contents: 
Return 


SARPRFUX 


standard  Exit 


Register  Contents; 
Entry 


On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry,  and  the  exit  must  place  a  return  code  in  register  15.  The 
return  codes  are: 


0  Do  not  override  SARPAC's  decision  as  to  whether  the  tape  should  be 
consolidated. 

4  Instruct  SARPAG  to  consolidate  the  tape. 

8  Instruct  SARPAG  to  not  consolidate  the  tape. 

User  Profile  Exit 

SARPRFUX  is  invoked  by  online  retrieval  at  logon  time  and  can  change  user 
profile  (def  user)  and  PF  key  information  dynamically. 

The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  GA-View  load  modules. 

The  standard  exit  that  is  supplied  with  GA-View  loads: 

■  Table  SARPFTAB,  v/hich  controls  PF  key  updating 

■  Table  SARUSRTAB,  which  controls  user  profile  overrides 

A  parameter  list  is  passed  to  the  exit  with  the  address  and  length  of  the  JCL 
records  and  the  mode  of  the  caller. 

The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  0  Gontains  entry  codes  as  follows: 

0  Specifies  a  new  user 

4  Specifies  an  existing  user 

Reg  1  Address  of  the  parameter  list  (mapped  by  macro  SARBPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 
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SARPRTUX-Banner  Page  Exit 


SARPRTUX-Banner  Page  Exit 

SARFRTUX  composes  a  banner  page  for  printed  SYSOUT. 

The  standard  exit  that  is  supplied  with  GA-View  produces  a  banner  page 
containing  the  SYSOUT  ID  and  job  ID  in  large  block  letters,  and  the  date  and  time 
of  archival.  It  calls  the  system  block  letter  routine,  IEFSD095.  The  routine  is 
described  in  IBM  manual,  OSA^S2  MVS  System  Programming  Library:  Job 
Management  GC28-0627  and  is  located  inidistribution  library  SYSl.AOSBO.  The 
exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  Hbrary 
containing  the  CA-View  load  modules. 

Rsgister  Contonts:  A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 

control  record,  the  group  control  record,  the  open  print  DCB  and  the  SYSOUT 
destination,  forms  name,  and  class.  The  contents  of  the  significant  general 
registers  on  entry  to  the  exit  are: 

Reg  0  Contains  entry  codes  as  follows: 

0  Specifies  the  start  of  the  SYSOUT  group 

4  Specifies  the  end  of  the  SYSOUT  group 

8  Specifies  that  the  VTAM  Print  option  is  about  to  open  a 
destination  in  PPIlVPTR 

This  can  be  changed  by  the  user. 

Reg  1  Address  of  the  print  parameter  list  (mapped  by  macro  SARPPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 
Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry. 


SARSECUX-Security  Exit 

SARSECUX  determines  whether  a  user  or  job  is  authorized  to  access  a  SYSOUT 
group  or  perform  online  tape  mounts.  The  exit  must  be  link-edited  with 
authorization  code  1  and  placed  in  the  library  containing  the  CA-View  load 
modules. 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  allows  access  to  all  users  and 

jobs. 
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SARSMFUX-SMF  Exit 


I  ) 


Other  Security  Exits  This  exit  can  be  used  in  conjunction  with  the  SARUSxUX  and  XMSCIitUX  user 
exits.  For  more  information,  see  the  descriptions  of  these  exits,  and  the  Security 
section  in  Chapter  3,  "Configuring  CA-View." 

Register  Contents.  A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 

control  record,  the  grot^  control  record,  the  job  name  the  user  HD,  the  RACF  user 
ID,  the  mode  of  the  caller,  and  the  function  for  which  the  group  is  being  accessed. 

The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are; 


RegO  Contains  entry  codes  as  follows: 

0  Called  firom  online 
4  Called  from  batch 

Reg  1  Address  of  the  security  parameter  list  (mapped  by  macro  SARCPL) 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 


Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry,  and  the  exit  must  place  a  return  code  in  register  15.  The 

return  codes  are: 

0  The  user/job  is  aufiiorized  to  access  the  SYSOUT  group. 

4  The  user /job  is  not  authorized  to  access  the  SYSOUT  group. 


SARSMFUX-SMF  Exit 

SARSMFUX  is  invoked  whenever  a  type-6  SMF  record  is  to  be  written  by  the 
archival  started  task.  The  exit  can  examine  and  modify  the  record,  or  it  can 
suppress  the  writing  of  the  record. 

The  exit  must  be  link-edited  with  the  authorization  code  1  and  placed  in  the 
library  containing  the  CA-View  load  modules. 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  returns  the  same  SMF  records  to 

be  written  that  it  receives. 
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SARSPFUX-Selection  List  Formatting  Exit 


Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Entry 

Reg  1  Address  of  fiie  type-6  SMF  record 

For  the  format  of  the  record,  see  the  section  SMF  Type-6  Records  in 
Chapter  3>  "Configuring  CA-View."  The  record  can  be  mapped  with 
system  macro  IFASMFR  6. 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit>  register  1  must  contain  the  address  of  the  SMF  record  to 

be  written,  registers  2  to  13  must  contain  the  same  contents  as  they  contained  on 
entry,  and  register  15  must  contain  one  of  the  following  return  codes: 

0  The  SMF  record  whose  address  is  in  register  1  is  to  be  written 

4  No  SMF  record  is  to  be  written 


SARSPFUX-Selection  List  Formatting  Exit 

SARSPFUX  formats  the  SYSOXJT  selection  list  for  online  retrieval.  The  exit  must 
be  link-edited  with  authorization  code  1  and  placed  in  the  library  containing  the 
CA-View  load  modules. 


Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  formats  the  selection  list  with 

the  following  data:  job  name,  job  ID,  archival  date  and  time,  generation  number, 
physical  location  of  the  SYSOUT,  number  of  lines,  number  of  pages,  and  any 
exception  code. 

A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master 
control  record,  the  group  control  record,  the  selection  list  heading,  and  the  entry 
in  the  selection  list.  The  contents  of  the  significant  general  registers  on  entry  to 
the  exit  are: 

Reg  0  Contains  entry  codes  as  follows: 

0  Creation  of  SYSOUT  Selection  List  entry  (for  ALL,  SARO  and 
SAR  modes) 

4  Creation  of  Report  Selection  List  entry  (for  ALL,  SARO  and  SAR 
modes) 


Register  Contents: 
Entry 
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SARSRQUX-Selection  Request  Exit 


Reg  1  Address  of  the  security  parameter  list  (mapped  by  macro  SARIPL) 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Return  contained  on  entry. 


SARSRQUX-Selection  Request  Exit 

SARSRQUX  examines  each  selection  code  entered  on  the  SYSGUT  selection  list. 
The  exit  can  process  the  request  itself  or  pass  it  on  to  CA-View  for  the  standard 
processing,  ^rvices  are  available  to  the  exit  to  update  the  user  data  in  the  group 
control  record  for  the  SYSOUT  group  selected,  and  copy  the  SYSOUT  group  to  a 
data  set  it  creates.  The  exit  must  be  link-edited  with  autihorization  code  1  and 
placed  in  the  library  containing  the  CA-View  load  modules. 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  passes  all  selection  codes  back 

to  CA-View  for  standard  processing. 

Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Entry 

Reg  0  Contains  entry  codes  as  follows: 

0  Selection  request  is  initially  being  passed 

4  Return  from  imsuccessfully  updating  the  user  data  in  the  group 
control  record 

8  Return  from  successfully  updating  the  user  data  in  the  group 
control  record 

12  Return  from  successfully  writing  SYSOUT  group  to  data  set 
16  Return  ficom  xmsuccessfuUy  writing  SYSOUT  group  to  data  set 
Reg  1  Address  of  the  security  parameter  list  (mapped  by  macro  SARLPL) 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 
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SARSTCUX-Archival  TaskExit 


Register  Contents: 
Return 


On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
Gontamed  on  entry,  and  the  exit  must  place  a  return  code  in  register  15  The 
return  codes  are:  ^  ‘ 


0  Request  is  processed 

4  Exits  processed  request,  no  message  is  returned 

8  Exits  processed  request,  a  message  is  returned,  and  the  alarm  is  sounded 

12  Exits  processed  request,  a  message  is  returned,  and  the  alarm  is  not  sounded 

16  The  GCR  user  data  is  updated  and  control  is  returned  to  the  exit 

20  The  SYSOUT  group  is  written  to  the  exit-suppHed  DCB  and  control  is 
returned  to  the  exit 


SARSTCUX-Archival  Task  Exit 

SARSTCUX  is  invoked  by  the  archival  started  task  at  the  following  times: 

■  When  it  begins  processing  a  SYSOUT  data  set 

■  As  it  gets  each  SYSOUT  record  m  the  data  set  from  JES 

■  When  it  completes  processing  of  the  data  set 

The  exit  can  be  used  to  modify  the  data  set  attributes  and  to  analyze  the  records 
for  exceptional  conditions.  The  generation  number,  sequence  number,  and 
archival  date  cannot  be  modified. 

Whenever  an  exceptional  condition  is  identified,  the  exit  can  do  any  of  the 
following: 

■  Return  a  message  to  be  displayed  via  a  WTO 

■  Set  a  short  exception  message  in  the  group  control  record  (GCRXCODE) 
which  is  displayed  in  the  SYSOUT  selection  list  used  for  retrieval 

■  Indicate  that  the  SYSOUT  for  the  job  is  to  be  printed 

■  Change  or  set  the  user  accounting  data  in  the  group  control  record 
(GCRUSER) 


Standard  Exit 


The  exit  must  be  link-edited  with- authorization  code  1  and  placed  in  the  library 
containing  the  GA-View  load  modules. 

The  standard  exit  that  is  supplied  with  CA-View  is  a  diunmy  routine  whicdi  merely 
returns  control  to  the  caller.  ^ 
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SARSTCUX-Archival  TaskExit 


Register  Contents: 
Entry 


Register  Contents; 
Return 


A  parameter  list  is  passed  to  the  exit  containing  the  addresses  of  the  master  control 
record,  the  group  control  record,  and  the  SYSOUT  record  and  the  length  of  the 
SYSOUT  record.  The  contents  of  the  significant  general  registers  on  entry  to  the  exit 
are: 

Reg  0  Contains  entry  codes  as  follows: 

0  Specifies  that  a  new  data  set  has  been  selected 

The  GCR  for  the  data  set  can  be  modified  as  needed  (except  the 
generation  number,  sequence  number,  and  archival  date). 

4  Specifies  firat  a  SYSOUT  record  is  being  passed  for  exceptional 
condition  analysis 

8  Specifies  ihe  end  of  the  cmrent  SYSOUT  group 
Reg  1  Address  of  the  security  parameter  list  (mapped  by  macro  SARSPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 

On  refiim  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  omentry. 

In  addition,  for  entry  code  4  (SYSOUT  record  passed  for  exceptional  analysis) 
and  8,  registers  0, 1,  and  15  must  be  returned  as  foUbws: 

0  Address  of  the  WTO  message  to  issue,  or  zero  if  no  message  is  to  be  issued 
1  Length  of  the  WTO  message  to  issue,  or  zero  if  no  message  is  to  be  issued 
15  The  following: 

0  The  SYSOUT  group  print  status  is  not  changed 
4  The  SYSOUT  group  is  printed 
8  The  SYSOUT  group  is  not  printed 

A  return  code  of  8,  returned  from  an  entry  code  8,  will  override  any  prior  print 
status  selected. 


SARSUBUX-Submit  Exit 


SARSUBUX-Submit  Exit 


SARSUBUX  is  invoked  by  online  retrieval  to  examine  and  control  the  submission 
of  jobs  for  CA-View.  The  exit  can  modify  the  records  for  CA-View  to  submit  or 
take  over  the  submission  of  the  J(CL  itself. 

The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules. 

Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  is  a  dummy  routine  that  merely 

returns  control  to  the  caller. 

Register  Contents:  A  parameter  list  is  passed  to  the  exit  with  the  address  and  length  of  the  JCL 

Entry  records  and  the  mode  of  the  caller.  The  contents  of  die  significant  general 

registers  on  entry  to  the  exit  are: 


Reg  0 


Regl 
Reg  13 
Reg  14 
Reg  15 


Contains  entry  codes  as  follows: 

0  Initial  call,  no  record  passed 
4  Record  is  passed  to  the  exit 
8  Final  call,  no  exit  passed 

Address  of  the  parameter  list  (mapped  by  macro  SARBPL) 
Address  of  a  standard,  72-byte  register  save  area 
Return  address 
Entry  point  address 


Register  Contents:  On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 

Rsturn  contained  on  entry.  For  the  initial  call  (function  code  0),  the  exit  must  place  a 

return  code  inregister  15.  The  return  codes  are: 


0  CA-View  submits  the  records  after  they  are  processed  by  the  exit: 

4  CA-View  does  not*  submit  the  records;  the  exit  handles  the  submission. 


SARTPOUX-Tape  Creation/Volser  Range  Exit 

SARTPOUX  is  available  for  customizing  tape  creation  and  is  most  commonly 
used  with  tape-emulation  optical  devices  in  conjunction  with  the  STORGRXn 
SARINIT  parameters  mxblli.  It  is  invoked  during  the  backup  cycle  and  SARP AC 
when  a  new  volume  is  created  from  a  Volser  range. 
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SARTPOUX-Tape  Creation/Volser  Range  Exit 


SARTPOUX  can  prevent  the  creation  of  the  next  volume  in  a  range,  causing 
SARTPOTUX  to  be  called  with  the  volume  after  that,  continuously,  until 
SARTPOUX  returns  0  to  indicate  that  a  given  volume  can  be  created:  (An 
optional  PTF  or  SARINIT  parameter  can  prevent  the  Volser  range  from  wrapping 
around.  See  version  SARTPGUl  on  the  distribution  tape  for  why  and  when  this 
exit  is  necessary.) 


Standard  Exit  The  standard  exit  that  is  supplied  with  CA-View  is  a  dummy  routine  which 

merely  returns  0  to  indicate  &at  the  given  volume  can  be  created. 

Register  Contents:  The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Entry 

RegO  Contains  entry  codes  as  follows: 

0  Initialization 

4  Termination 

8  EOV  was  reached,  proposal  to  create  new  volume 

Reg  1  Address  of  the  parameter  list  (for  entry  code  8  only): 

Word  1  Address  of  volume  name  just  created  that  reached  EOV 
Word  2  Address  of  name  of  proposed  new  volume 
Reg  13  Address  of  a  standard,  72-byte  register  save  area 
Reg  14  Return  address 

Reg  15  Entry  point  address 

Register  Contents:  On  return  from  the  exit,  registers  0-13  must  contain  the  same  contents  as  they 

Return  contained  on  entry.  A  non-zero  register  15  on  exit  from  entry  codes  0  and  4  is 

ignored. 

If  register  15  is  non-zerc-  on  return  from  entry  code  8,  the  proposed  new  volume 
will  not  be  created;  rather,  SARTPOUX  will  be  called  again,  proposing  that  the 
next  volume  from  the  range  be  created.  SARTPOUX  must  eventually  return  0  in 
register  15  to  indicate  that  a  given  volume  can  be  created.  (Optionally,  a  PTF  or  a 
SARINIT  parameter  can  be  used  to  prevent  the  Volser  range  from  wrapping,  thus 
causing  the  backup  cycle  or  SARPAC  to  abend  in  the  event  that  the  Volser  range 
is  exhausted.  An  administrator  would  have  to  reset  the  Volser  range  with 
SARINIT.) 
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SARUSxUX-User  ID  Determination  Exits 


SARUSarUX  represents  the  user  ID  determination  exits  for  online  retrieval.  The 
exits  are: 


Standard  Exit 


SARUSAUX 

SARUSBUX 


SARUSDUX 


SARUSRUX 

SARUSTUX 

SARUSVUX 


SARUSXUX 


For  native  VTAM  online  retrieval 
For  batch  retrieval  (SARBCH) 

For  CA-DRAS  interface 

For  GA-Roscoe  online  retrieval 

For  native  TSO  and  SPF/ISPF  online  retrieval 

For  VM/ CMS  online  retrieval 

For  cross-memory  feature 


The  exits  are  called  by  the  appropriate  retrieval  option  to  supply  and  verify  the 
user  ID  whenever  the  retrieval  option  is  initially  invoked  by  a  user.  For  online 
retrieval  options,  the  exit  can  optionally  request  GA-View  to  prompt  the  user  for 
a  user  ID  and  password; 

The  exit  must  be  link-edited  with  authorization  code  1  and  placed  in  the  library 
containing  the  CA-View  load  modules. 

The  standard  exits  that  are  supplied  with  CA-View  perform  the  following: 


SARUSAUX  (VTAM) 
SARUSBUX  (BATCH) 


SARUSDUX(GA-DRAS) 


SARUSRUX  (CA-ROSCOE) 

SARUSTUX  (TSO/SPF/ISPF) 

SARUSVUX  (VM/CMS) 

SARUSXUX  (CROSS 
MEMORY) 


Prompts  the  user  for  user  ID  and  password 

Extracts  job  name,  RACF  user  ID  for  USER 
parameter  on  job  card,  or  user  ID  from  the  PSCB 

Accepts  user  ID  and  password  from  CA-DocView 
and  CA-DocView/Web 

Prompts  the  user  for  user  ID  and  password 

Extracts  the  user  ID  from  the  PSCB 

Extracts  the  CMS  user  ID 

Prompts  the  user  for  user  ID  and  password 
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SARUSxUX-User  ID  Determination  Exits 


Register  Contents: 
Entry 


Register  Contents; 
Return 


Other  Seourity  Exits 


The  contents  of  the  significant  general  registers  on  entry  to  the  exit  are: 

Reg  0  Contains  function  codes  as  follows: 

0  Initiation  of  retrieval  option 

4  Termination  of  retrieval  option 

Reg  1  Address  of  the  parameter  list  (mapped  by  macro  SARUPL) 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry,  and  the  exit  must  place  a  return  code  in  register  15.  The  return 
codes  are: 

0  Allows  access  to  the  user 
4  Denies  access  to  the  user 

8  Prompts  user  for  user  ID  and  password  and  returns  control  to  exit  (for  online 
retrieval  only) 

12  For  online  retrieval,  user  is  prompted  for  the  user /password,  a  message  is 

returned,  and  the  alarm  is  soimded 

For  batch  retrieval,  a  message  is  printed,  the  requested  function  is  denied,  and 
processing  continues  with  the  next  control  statement 

16  For  online  retrieval,  user  is  prompted  for  the  user  ID/password,  a  message  is 
returned,  and  the  alarm  is  not  sounded 

20  For  online  retrieval,  verify  that  the  user  ID  and  password  supplied  by  the  exit 
are  the  same  as  those  in  the  database 

For  batch  retrieval,  a  message  is  printed,  the  requested  function  is  denied,  and 
processing  continues  with  the  next  control  statement. 


This  exit  can  be  used  in  conjunction  with  the  SARSEGUX  and  WSCTrUX  user 
exits.  For  more  information,  see  the  descriptions  of  these  exits,  and  the  Security 
section  in  Chapter  3,  "Ccmfiguring  CA-View." 


SARXCTUX-Exceptional  Condition  Checking  Exit 


SARXCTUX-Exceptional  Condition  Checking  Exit 

SARXCTUX  can  be  customized  to  analyze  and  make  a  final  decision  when  a  user 
specified  or  system  exceptional  condition  is  detected.  This  exit  can  be  used  to 
change  the  GCRXGODE  field,  optionally  bypassing  exceptions  for  the  remainder 
of  the  SYSOUT  group,  and  communicate  the  exception  results  with  a  message  or 
notify  another  system. 

Standard  Exit  The  standard  exit  distributed  with  the  product  is  a  null  exit  that  simply  returns  to 

the  caller. 

invoked  by  SARXCTUX  is  invoked  by  the  archival  task  at  the  following  times: 

■  During  its  mitializationi 

■  As  it  begins  a  new  SYSOUT  group 

■  After  an  exceptional  condition  is  detected 

■  At  the  end  of  the  SYSOUT  group 

■  During  its  termination 

Register  Contents:  The  SARXGL  parameter  list  is  passed  to  the  exit  containing: 

Entry 

■  Address  of  the  master  control  record  (MGR) 

■  Address  of  the  group  control  record  (GCR)  with  the  current  XGODE  in  the 
GCRXGODE  field  (GGR  is  not  present  for  initialization  and  termination 
entries) 

■  Address  and  length*  of  the  current  record  (for  exception  detected  entry  only) 

■  GA-View  database  high  level  index  name 

■  Previous  exception  code,  blanks  if  none 

■  Bypass  (stop)  SARXGT  program  flag 

■  30-word  user  exit  work  area 
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SARXCTUX-Exceptional  Condition  Checking  Exit 


Register  Contents: 
Return 


The  significant  contents  of  the  general  registers  on  entry  are: 

RegO  Contains  function  codes  as  follows: 

0  Initialization  of  archival  task 
4  Beginning  of  a  new  SYSOUT  group 

8  Exceptional  condition  detected  in  the  SYSOUT  record  during 
archiving 

The  address  and  length  of  the  record  are  provided  in  the 
SARXCL  parameter  list. 

12  End  of  the  SYSOUT  group 

16  Termination  of  the  archival  task 

Reg  1  Address  of  the  SARRXCL  parameter  list 

Reg  13  Address  of  a  standard,  72-byte  register  save  area 

Reg  14  Return  address 

Reg  15  Entry  point  address 

On  return  from  the  exit,  registers  2  to  13  must  contain  the  same  contents  as  they 
contained  on  entry,  and  the  exit  must  place  a  return  code  in  register  15.  The 
return  codes  are: 

0  Normal  return  code 

4  Entry  code  8  only;  bypass  SARXCT  exceptional  condition  program  for  the 
remainder  of  the  group 

A  customized  SARSTCUX  can  still  modify  the  GCRXCODE. 
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Chapter  1 2 

Diagnostic  and  Error  Messages 


In  This  Chapter 

CA-View  identifies  dynamic  allocation  errors  with  the  actual  error  and 
information  codes  returned  from  dynamic  allocation.  A  description  of  the 
possible  dynamic  allocation  error  codes  can  be  foimd  in  the  tutorial  for  the  online 
retrieval  facility. 

Alternatively,  the  definition  of  the  error  can  be  found  in  the  IBM  manual,  OS/VS2 
MVS  System  Programming  Library:  Job  Management,  GC28-0627. 

This  chapter  documents  the  CA-View  diagnostic  and  informational  messages. 


Diagnostic  and  Error  Messages 

EBCCIEO 1  NON-MVS/XA  EXECUTION  NOT  ALLOWED 

Reason;  You  are  not  using  MVS/ESA;  E22CEND  requires  MVS/ESA  to  work. 
Action:  Use  MVS/ESA,  then  try  again. 

EBCCIE02  NON-CICS/XA  EXECUTION  NOT  ALLOWED 

Reason:  The  DFHPPT  or  RDO  definition  for  the  E22CIEND  program  is  wrong. 
The  comment  indicates  the  specific  error.  You  are  possibly  not  using  Version  2.1.1 
or  a  later  version  of  GICS.  E22CEND  requires  Version  2.1.1  or  a  later  version  of 
CICS  to  work. 


Action:  Correct  the  E22CIEND  definition. 
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Diagnostic  and  Error  Messages 


EBCCIE03 


EBCCIE10 


EBCCIE99 


EBCCIN01 


EBCCIN02 


XMS  SUPPORT  SUBTASK  STOP  FAILED 

Reason;  The  E22XSTSK  has  not  shut  down  after  waiting  10  seconds.  The 
termination  program  wOli  stop  with  this  error. 

Action;  Contact  Computer  Associates  Technical  Support. 


E22XSTSK  SUBTASK  TERMINATE  REQUESTED 

Reason;  The  subtask  termination  program  has  requested  that  the  MVS  subtask 
terminate;  this  occurs  when  CICS  is  being  shut  down  and  the  PLTSD  program  is 
executed,  or  when  a  terminali  operator  requests  that  the  subtask  be  shut  down 
through  the  operator  interface  (CICS  OP20  transaction). 

Action;  None.  This  in  an  informational  message. 


XMS  SUPPORT  TASK  STOPPED 

Reason:  E22aEND  terminated  the  MVS  subtask  program  E22XSTSK. 
Action:  None.  This  is  an  informational  message. 


NON-MVS/ESA  EXECUTION  NOT  ALLOWED 

Reason;  You  are  not  using  MVS/ESA.  E22CINIT  requires  MVS/ESA  to  work. 
Action:  Use  MVS/ESA,  then  try  again. 


NON-CICS/XA  EXECUTION  NOT  ALLOWED 


Reason:  The  DFHPPT  or  RDO  definition  for  the  E22CINIT  program  is  wrong. 
The  comment  indicates  what  specifically  was  found  to  be  in  error.  You  are 
possibly  not  using  Version  2.1.1  or  a  later  version  of  CICS.  E22CINn'  requires 
Version  2.1.1  or  a  later  version  of  CICS  to  work. 


Action:  Correct  the  E22CIEND  deficution. 
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Diagnostic  and  Error  Messages 


EBCCIN03 


EBCCIN04 


EBCCIN05 


EBCCIN06 


EBCCINQ7 


USER  SUB-POOL  GETMAIN  FAILURE 

Reason:  E22CINrr  could  not  get  enough  storage  to  initialize.  The  MAXUSER 
parameter  in  E22XMGTR  is  used  to  determine  the  initial  storage  requirements. 

Action:  Reduce  the  value  assigned  to  MAXUSER  or  increase  the  storage 
available  above  the  Sl-bit  lihe  in  the  region. 


SERVICE  TRANSACTION  TRANID  ERROR 

Reason:  E22CINIT  could  not  start  the  service  transaction  defined  in  the 
E22XMGTR  table.  This  transaction  is  required.  The  subtask  is  consequently 
terminated. 

Action:  Try  to  execute  E22GINIT  again. 


EBCXSTSK  AHACH  FAILURE 

Reason:  E22GINIT  could  not  start  the  E22XSTSK  subtask.  The  system  cannot  be 
initialized. 

Action:  Try  to  execute  E22GINIT  again. 


EBCXSTSK  ALREADY  ACTIVE,  CONTROL  TABLE  (E22XMCTR) 
RELOADED 

Reason:  The  subtask  is  active  when  E22GINIT  was  executed.  The  control  table 
was  reloaded  and  no  other  changes  were  made.  Some  initialization  options 
(MAXUSER,  MSGLVL)  are  ignored. 

Action:  None.  This  is  an  informational  message. 


WAITLIST  GETMAIN  FAILURE 

Reason:  E22GINIT  requires  more  storage  above  the  24-bit  line  to  be  initialized. 

Action:  Increase  the  MVS  storage  above  the  line  required  by  increasing  the 
region  size  of  GIGS  or  TSOi 
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Diagnostic  and  Error  Messages 


EBCCIN08 


EBCCIN09 


EBCCINIO 


EBCCIN11 


EBCCIN99 


CICS  RELEASE  DEPENDENT  MISSING 


Reason:  E22CINIT  coxild  not  find  either  the  E22C0330  (for  Version  3.3.0)  or 
E22C0211  (for  Version  2.1.1)  CICS  release-dependent  programi 

Action:  Define  the  E22C0330  or  E22C0211  program  to  the  Resource  Definition 
Online  (RDO);  then  try  againi 


REQUIRED  PROGRAMS  MISSING  FROM  STEPLIB/DFHRPL 

Reason:  The  E22CINn'  program  has  checked  and  fotmd  one  or  more  reqxiired 
programs  cannot  be  loaded  from  the  STEPLIB  or  DFHRPL. 

Action:  Review  the  CICS  JGBLOG  for  EBCCINIO  or  EBCCINll  error  messages 
indicating  the  specific  programs  that  are  not  fotmd.  Copy  the  required  programs 
to  the  STEPLIB/DFHRPL  and  restart  the  initialization  process. 


pgm-name  NOT  IN  STEPLIB 

Reason:  The  listed  program  is  not  foimd  in  the  STEPLIB  and  is  required  for 
normal  operation. 

Action:  Move  the  program  to  the  CICS  STEPLIB. 

Note:  This  program  cannot  be  loaded  from  the  CICS  DFHKPL  libraries. 


pgm-name  NOT  IN  DFHRPL 

Reason:  The  listed  program  is  not  foimd  in  the  DFHRPL  and  is  required  for 
normal  operation. 

Action:  Move  the  program  to  the  CICS  DFHRPL. 

Note:  The  program  cannot  be  loaded  from  the  CICS  STEPLIBOr  Imklist. 


XMS  SUPPORT  TASK  READY  (XM15) 

Reason:  E22CINIT  finished  initializing  without  error. 
Action:  None.  This  is  an  informational  message. 
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EBCCIS01 


EBCCIS02 


EBCCIS03 


EBCCIS04 


EBCCIS05 


EBCCIS06 


NON-MVS/ESA  EXECUTION  NOT  ALLOWED 


Reason:  You  are  not  using  MVS/ESA.  E22CISRV  requires  or  MVS/ESA  to 
work. 


Action:  Use  MVS/ESA.  then  try  again. 


NON-CICS/XA  EXECUTION  NOT  ALLOWED 


Reason:  The  DFHPPT  or  RDO  definition  for  the  E22CISRW  program  is  wrong. 
The  comment  indicates  what  specifically  was  foimd  to  be  in  error.  You  are 
possibly  not  using  Version  2.1.1  or  a  later  version  of  GIGS.  E22CISRV  requires 
Version  2.1.1  or  a  later  version. 

Action:  Gorrect  the  E22CISRV  definition. 


E22XSTSK  NOT  ACTIVE 

Reason:  The  E22XSTSK  program  is  not  executing.  E22GISRV  requires  the 
E22XSTSK  to  work.  E22QSRV  ends.  E22GINIT,  which  starts  the  subtask,  was  not 
executing,  or  the  subtask  was  stopped; 

Action:  See  your  operations  administrator  for  more  information. 


INVALID  EBCXSCTL  BLOCK  FOUND 

Reason:  An  internal  error  occurred  in  E22GISRV. 

Action:  Gontact  Gomputer  Associates  Technical  Support. 


E22CISRV  PROGRAM  IS  NOT  A  TERMINAL  PROGRAM 

Reason:  E22GISRV  is  not  designed  to  be  attached  to  a  terminal.  E22GISRV  ends. 
Action:  Refrain  from  executing  E22GISRV  from  a  terminal. 


E22CISRV  PROGRAM  HAS  ABENDED 

Reason:  The  service  program  has  abended  and  will  be  shut  down. 
Action:  Gontact  Gomputer  Associates  Technical  Support. 
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EBCCMS02 


EBCCMS03 


EBCCMS04 


EBCCMS05 


EBCCMS06 


EBCCMS07 


PARAMETER  FILE  NOT  FOUND 

Reason:  Unable  to  find  CA^View  parameter  file  SARIDX  FILE. 
Action:  Ensure  that  the  file  is  accessible,  then  retry. 

UNDEFINED  PARAMETER  CONTROL  STATEMENT 

Reason:  Parameter  file  contains  an  invalid  control  statement. 
Action:  Correct  and  retry. 

I/O  ERROR  PROCESSING  PARAMETER  FILE  CODE  xx 

Reason:  An  I/O  error  xx  occurred  frying  to  read  the  parameter  file. 
Action:  Correct  and  retry. 


INVALID  OR  MISSING  USER  NAME 

Reason:  The  user  name  value  on  die  USER  control  statement  is  either  missing  or 
invalid. 

Action:  Correct  and  retry. 


INVALID  USER  PASSWORD 

Reason:  The  password  value  on  the  USER  control  statement  is  either  missing  or 
invalid. 

Action:  Correct  and  retry. 


INVALID  OR  MISSING  HIGH-LEVEL  NAME 

Reason:  The  CA-View  database  high-level  name  password  value  on  the  NAME 
control!  statement  is  either  missing  or  invalid. 

Action:  Correct  and  refry. 
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^  EBCCMS08  MODULE  xxxxxxxx  NOT  FOUND 

Reason:  Unable  to  load  the  indicated  program  because  the  program  is  either  not 
accessible  or  is  not  authorized. 

Action:  Correct  and  retry. 

EBCCMS09  INVALID  OR  MISSING  VIRTUAL  DISK  ADDRESS 

Reason:  The  value  on  the  VOL  control  statement  is  either  missing  or  invalid. 
Action:  Correct  and  retry. 

EBCCMS10  PRECEDING  FILEDEF  FAILED 

Reason:  The  preceding  FILEDEF  failed. 

Action:  Correct  and  retry. 


EBCCMSl  1  LINK  FAILED  FOR  VIRTUAL  VOLUME  xxx 

Reason:  The  attempt  to  link  to  the  indicated  volume  as  MW  failed. 
Action:  Correct  and  retry. 


EBCCMSl 2  VOLUME  PREVIOUSLY  DEFINED 

Reason:  You  have  more  than  one  VOL  control  statement  for  the  same  volume. 
Action:  Correct  and  retry. 

EBCCMS 1 3  TOO  MANY  DISK  VOLUMES 

Reason:  All  26  disk  modes  are  in  use. 

Action:  Release  unnecessary  disks  and  retry. 


EBCCMS  1 4  ACCESS  FAILED  FC»  VIRTUAL  VOLUME  xxx 

Reason:  The  ACCESS  attempt  for  the  indicated  volume  failed. 
Action:  Correct  and  retry. 
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EBCCMS15 


EBCCMS19 


EBCDBIOO 

through 

EBCDBI13 


UNABLE  TO  DETERMINE  VM  LEVEL  ¥OR:xxxxxxxx 


Reason:  The  indicated  CP  LEVEL  is  unknown  to  this  version  of  the  program, 
and  automatic  adjustments  to  differing  VM  internal  control  blocks  cannot  be 
performed. 

Action:  Contact  Computer  Associates  Technical  Support. 


INVALID  SPOOL  PUNCH  USER  FOR  SUBMIT 

Reason:  The  value  on  the  SUBMIT  control  statement  is  either  missing  or  invalid. 
Action:  Correct  and  retry. 


EBCDBIOO  DATABASE  DOES  NOT  EXIST 

EBCDBIOl  ALLOCATION  FAILED  -  ERROR=xxxx,  \WO=xxxx 

EBCDBI02  PHYSICAL  I/O  ERROR  -  ECB=xxxx>ocxx 

EBCDBI03  DATASET  NUMBER  OUT  OF  RANGE  -  DCCBsXXXXXXXx 

EBCDBI04  DATASET  RENAME  FAILED  FOR  function 

EBCDBI05  UNSUPPORTED  DEVICE  TYPE  -  BLKS/CYLsnnnn  , 

EBCDBI06  MORE  THAN  127  DATASETS  -  NUMBER=nnnnn 

EBCDBI07  NO  MORE  SPACE  IN  DATASET 

EBCDBI08  MISSING  HIGH-LEVEL  INDEX  NAME  OF  DATABASE 

EBCDBI09  LOGICAL  I/O  ERROR,  xxxKEy=Xyyyyyyyyyyyyyyyy’ 

EBCDBMO  UNEXPECTED  END  OF  DATA,  xxxKEY= 

X’yyyyyyyyyyyyyyyy’ 

EBCDBIll  RECORD  NOT  FOUND,  xxxKEY= 

X’yyyyyyyyyyyyyyyy’ 

EBCDBIl  2  LOCK  DATASET  ALREADY  EXISTS 
EBCDBM  S  LOCK  DATASET  DOES  NOT  EXIST 


Reason:  An  I/O  error  occurred  with  the  CA-View  database  as  described  by  the 
text  of  the  message.  In  these  messages: 


XXX 


Specifies  the  control  block  being  processed  (SFB>  IFB, 
orXFB) 


yyyyyyyyyyyyyyyy  Specifies  the  key  of  the  record  in  hex. 

If  the  key  is  longer  than  16  bytes,  only  the  first  16 
bytes  are  shown 
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EBCDBP01 


EBCDRVOl 


These  messages  can  also  have  the  following  appended  to  them: 
,  program-nasns  LOCA.TXOtl  n 


where: 


program-name  Is  the  name  of  a  CA-View  programi  (such  as  SARPAM) 

w  Is  a  number  identifying  the  location  in  the  program  where 

the  error  was  detected 

Action:  Correct  the  problem  witih  the  database.  This  can  require  copying  the 
database  with  the  SARDBASE  utility  or,  in  the  extreme  case,  recovering  the 
database.  See  Chapter  7,  "Database  Utilities,"  and  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  information. 

For  information  about  the  error  codes  contained  in  the  EBCDBIOl  message,  refer 
to  the  IBM  manual  GC28-1645,  AppZfcflfion  Development  Guide:  Authorized 
Assembler  Language  Programs.  See  the  section  about  requesting  SVC99  functions. 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP. 

INVALID  bik 

Reason:  A  CA-View  program  has  terminated,  and  a  dump  was  generated.  In  this 
message  blk  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  IFB,  SFB,  XFB>  or  DBB).  Itmay  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program  detected  the  problem. 

Action:  Send  the  dump  to  Computer  Associates  Technical  Support.  Restart  the 
program  that  was  terminated.  If  the  problem  recurs,  nm  SARDBASE  VERIFY  on 
the  database.  If  the  problem  persists,  contact  Computer  Associates  Technical 
Support. 


pgm-name  SUBTASK  ATTACHED 

Reason:  The  operator  commimication  subtask  has  attached  and  is  ready  to 
accept  operator  commands.  This  message  has  a  MSGLVL  of  NORM. 


Action:  None. 
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EBCDRV02 


EBCDRV03 


EBCDRV04 


EBCDRV05 


EBCDRV06 


pgm-name  SUBTASK  ATTACHED 

Reason:  The  cross-memory  signon  subtask  has  attached  and  is  ready  to  except 
cross-memory  logon  requests.  This  message  has  a  MSGTVL  of  NORM. 


Action:  None. 


pgm-name  SUBTASK  ATTACHED  APPLID=applid 

Reason:  The  VTAM  signon  subtask  has  attached  to  open  the  VTAM  ACB  and 
attach  VTAM  exits.  This  message  has  a  MSGLVL  of  NORMt 

Action:  Correct  the  input  parameters,  then  restart  the  region. 


pgm-name  CANNOT  BE  USED  WITH  parm-name=value 

Reason:  Ihitialization  has  detected  incompatible  input  parameters.  These 
parameters  carmot  be  used  togetiier.  For  example,  LGNIMT=  cannot  be  specified 
when  SARVTDB=  is  used  because  LGNFMT=  specifies  the  FORMAT  of  the 
VTAM  logon  data,  and  SARVTDB=  indicates  the  logon  data  is  to  be  replaced  by  a 
specific  qualifier.  You  cannot  do  both  at  the  same  time. 

Action:  Correct  the  input  parameters,  then  restart  the  region. 


XXXXXX=  MUST  BE  SPECIFIED  WITH  YYYYY=ZZZZZ 

Reason:  Initialization  has  detected  that  a  input  parameter  that  requires  a  missing 
input  parameter.  For  instance  SARAPPL=  must  be  specified  when  SARVTDB=  is 
used  because  SARAPPL=  specifies  that  the  VTAM  interface  will  be  used,  and 
SARVTDB=  is  only  valid  when  VTAM  is  initialized. 


Reason:  Correct  the  input  parameters,  then  restart  the  region. 


VTAMPASS=YES  IS  SPECIFIED,  BUT  NO  VTAM  INTERFACE  IS 
ACTIVE 

Reason:  Initialization  has  detected  that  a  input  parameter  that  specifies  how 
VTAM  logon  processing  will  occur,  but  none  of  the  VTAM  interfaces 
(SARAPPL=,  RMOAPPL=  INBAPPL=)  were  specified. 


Action:  Correct  the  input  parameters,  then  restart  the  region. 
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EBCDRV07 


EBCDRV08 


EBCDRV09 


EBCDRV10 


EBCDRVl  1 


VTMSAA=YES  IS  SPECIFIED,  BUT  NO  VTAM  INTERFACE  IS  ACTIVE 

Reason:  Initiali2ati6n  has  detected  that  a  input  parameter  that  specifies  how 
VTAM  logon  processing  wiU'occur,  but  none  of  the  VTAM  interfaces 
(SARAPPL=,  RMOAPPL=  INBAPPL=)  were  specified. 


Action:  Correct  the  input  parameters,  then  restart  the  region. 


VTMQUERY=  IS  SPECIFIED,  BUT  NO  VTAM  INTERFACE  IS  ACTIVE 

Reason;  Initialization  has  detected  that  a  input  parameter  that  specifies  how 
VTAM  logon  processing  will  occur,  but  none  of  the  VTAM  interfaces 
(SARAPPL=,  RMOAPPL=  INBAPPL=)  were  specified. 


Action:  Correct  the  input  parameters,  then  restart  the  region. 


VTAM  INTERFACES  ARE  STARTED  BY  SARAPPL=,  RMOAPPL=  OR 
INBAPPL=  SPECIFICATIONS 

Reason:  EBCDRV06,  EBCDRV07,  EBCDRV08  was  issued  previously.  This 
message  indicates  that  SARAPPL=,  RMOAPPL=,  or  INBAPPL=  can  be  used  to 
initialize  the  VTAM  interface. 

Action;  Correct  the  input  parameters,  then  restart  the  region. 


PC  PROGRAM  pgm-name  ACTIVE  ADDRsaxxxxx  x.x  xxIxxIxx 

Reason;  The  displayed  PC  call  routine  has  been  loaded  into  the  CSA  at  the 
address  shown.  The  release,  assembly  date,  and  time  are  also  shown.  This 
message  has  a  MSGLVL  of  INFO; 

Action:  None. 


PC#xxxx  ASID=xxxx  XMEMCNTL  ADDR=xxxxxx  IDsxxxxxxxx 

Reason;  The  PC  call  function  is  now  available  to  allow  cross-memory 
communication  to  take  place.  The  E22XMSGN  routine  must  start  before  cross¬ 
memory  signons  can  process.  This  message  has  a  MSGLVL  of  NORMi 

Action:  None. 
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EBCDRV12 


EBCDRV30 


EBCDRV31 


EBCDRV32 


EBCDRV33 


NO  USER  INTERFACE  WAS  SPECIFIED,  EITHER  USE  XMS=YES.  OR 
USE  A  VTAM  INTERFACE. 


Reason;  Initialization  has  detected  that  a  input  parameter  that  requires  a  missing 
input  parameter.  For  instance  SARAPPL=  must  be  specified  when  SARVTDBs:  is 
used.  This  is  because  SARAPPL=  specifies  that  the  AM  interface  wiU  be  used, 
and  SARVTDB=  is  only  valid  whenATTAM  is  initialized. 

Action;  Correct  the  input  parameters,  then  restart  the  region. 


pgm-name  DETACHED 

Reason;  The  operator  communication  subtask  has  detached  and  is  no  longer 
available.  If  any  signon  subtasks  are  still  attached,  they  are  forced  off  and  the 
region  will  finish  terminating.  This  message  has  a  MSGLVL  of  CRIT. 


Action:  None. 


pgm-name  DETACHED 

Reason:  The  cross-memory  signon  subtask  has  detached  and  is  no  longer 
available.  This  message  has  a  NKGLVL  of  CRIT. 

Action:  None. 


pgm-name  DETACHED  APPLID=opp//cf 

Reason;  The  VTAM  signon  subtask  has  detached  and  is  no  longer  available.  This 
message  has  a  MSGLAT.,  of  GRIT. 

Action:  None. 


E22DRVLG  SYSLOG  WRITER  STOPPED 

Reason;  The  SYSPRINT  writer  subtask  has  stopped.  This  will  normally  occur 
when  the  region  is  shut  down.  It  will  also  occur  when  the  SYSPRINT  log  writer 
did  not  find  a  SYSPRINT  DDCARD  or  the  SYSPRINT  log  writer  has  abended  for 
some  reason. 

Action:  If  the  SYSLOG  writer  abended,  you  should  contact  Computer  Associates 
Technical  Support;  otherwise  no  action  should  be  taken. 
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EBCDRV40 


EBCDRV80 


EBCDRV90 


EBCDRV91 


EBCDRV99 


SUBTASK  FORCED  TO  DETACH  PQM-pgm-name 

Reason;  The  operator  subtask  terminated  and  this  subtask  was  still  active. 
CA-View  has  forced  the  subtask  to  shut  down.  This  message  has  a  MSGLVL  of 
GRIT. 

Action:  Contact  Computer  Associates  Technical  Support. 


MSGn  QUEUE  ALLOCATED  xxxxxxxx  1  Sl=xxxxxxxx 
S\lE=xxxxxxxx  FREE  =xxxxxxxx 

Reason:  The  SYSPRINT  message  queue  was  allocated  in  storage. 
Action:  None. 


RTUS  POOL  ALLOCATED  xxxxx  1  ST  xxxxx  END  xxxxx  SIZE  xxxx 
NEXT  xxxxx 

Reason:  Issued  when  the  cross-memory  region  started.  The  size  and  location  of 
the  pool  of  user  control  blocks  received  at  system  startup  are  displayed.  This 
message  has  a  MSGLVL  of  NORM. 

Action:  The  USERMAX  initialization  parameter  sets  the  maximum  number  of 
user  control  blocks  to  allocate  in'  the  region.  To  increase  the  USERMAX 
initialization  parameter,  you  must  shutdown  and  restart  the  region. 


WAITING  FOR  TASK  TO  END 

Reason;  The  cross-memory  region  is  terminating,  but  some  subtasks  are  stiU 
active. 

Action:  Wait  for  aU  subtasks  to  end. 


xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  input  parameter  shown  is  unknown  or  invalid.  The  region  will 
abend.  This  message  has  a  MSGLVL  of  CRIT. 


Action:  None. 
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EBCIFP02 


EBCOCLS2 

EBCOCLS4 


EBCOCLS5 

EBCOCLS6 


EBCOCMIO 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP. 

INVALID  bik 

Reason:  A  CA-View  program  has  terminated,  and  a  dump  was  generated.  In  this 
message,  WA:  specifies  the  controlhlock  CA-View  expected  but  did  not  receive 
(usually  IFB>  SFB,  XFB,  or  DBB).  Itmay  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program  detected  the  problem: 

Action:  Send  the  dump  to  Computer  Associates  Technical  Support.  Restart  the 
program  that  terminated.  If  the  problem  recurs,  run  SARDBASE  VERIFY  on  the 
database.  If  the  problem  persists,  contact  Computer  Associates  Technical 
Support. 


pgm-name  VTAM  xxxxxxxxxxxxxxxxxxxxxxxx 


Reason:  The  CLOSE  operator  command  is  attempting  to  close  the  VTAM 
interface  ACB.  The  possible  programs  are  SARVTAM,  INBVTAM,  RMOVTAM. 
This  message  has  a  MSGLVL  of  OPER: 

Action:  The  text  indicates  whether  there  was  an  error.  If  there  was  an  error, 
contact  Computer  Associates  Technical  Support. 


pgm-name  VTAM  IS  NOT  VALID  FOR  THIS  REGION 


Reason:  The  CLOSE  operator  command  has  been  issued,  but  the  VTAM 
interface  ACB  is  not  open.  The  possible  programs  are  INBVTAM  and 
RMOVTAM.  This  message  has  a  MSGLVL  of  OPER. 

Action:  Verify  that  the  specified  ACB  is  open. 


OPERAND  (xxxxxxxx  -  VALUE  n)  MUST  BE  YES/NO 

Reason:  The  operator  command  operand  must  be  either  YES  or  NO:  This 
message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand. 
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EBCOCMll 


EBCOCM12 


EBCOCM13 


EBCOCM14 


EBCOCM16 


EBCOCMDl 


OPERAND  (xxxxxxxx  -  VALUE  n)  CAN  ONLY  HAVE  A  SINGLE 
VALUE 


Reason:  The  operator  command  operand  must  not  specify  more  than  one  value. 
This  message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand. 

OPERAND  (xxxxxxxx  -  VALUE  n)  CAN  ONLY  HAVE  10  VALUES 

Reason:  The  operator  command  operand  is  limited  to  10  values.  This  message 
has  a  MSGLVL  of  OPER 

Action:  RO-issue  the  command  with  a  valid  operand. 


OPERAND  (xxxxxxxx  -  VALUE  n)  INVALID  NUMERIC 
OPERAND 

Reason:  The  operator  command  operand  must  be  a  number.  This  message  has  a 
MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand. 


OPERAND  (xxxxxxxx)  CANNOT  HAVE  A  VALUE 

Reason:  The  operator  conunand  operand  cannot  be  assigned  a  value.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand. 


USERssxxxxxxxxxxxxxxxxxxxxxxxxWAS  NOT  FOUND 

Reason;  The  operator  command  could  not  locate  this  user  on  the  system.  This 
message  has  a  MSGLVL  of  OPER. 

Action;  Re-issue  the  conunand  with  a  valid  user's  connect  ID; 


->  command-name 

Reason;  The  displayed  operator  command  was  entered.  This  command  will  now 
be  processed.  This  message  has  a  MSGLVL  of  OPER. 


Action:  None. 
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EBCOCMD2 


EBCOCMD3 


EBCOCMD4 


EBCOCMD5 


EBCOCMD6 


EBCOCMD7 


COMMAND  (command-name)  NOT  KNOWN 

Reason:  The  displayed  operator  eommand  is  not  valid  for  cross-memoiy.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  Re-enter  a  valid  cross-memory  operator  command. 


OPERAND  (operand-name)  NOT  KNOWN 

Reason:  The  operator  command  operand  is  not  valid.  This  message  has  a 
MSGLVL  of  OPER 

Action:  Re-enter  the  cross-memory  operator  command  with  a  valid  operand. 


OPERAND  (operand-name)  IS  NOT  VALID  FOR  command- 
name 

Reason:  The  operand  is  not  valid  for  this  operator  command.  This  message  has  a 
MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand. 


OPERAND  (operand-name)  DID  NOT  HAVE  A  VALUE 

Reason:  The  operator  command  operand  did  not  specify  a  value.  This  message 
has  a  MSGLVL  of  OPER. 

Action;  Re-issue  the  command  with  a  value. 

OPERAND  (xxxxxxxx  -  VALUE  n)  UNBALANCED  QUOTES 

Reason;  The  operator  command  operand  must  end  with  a  quote  mark  if  it  begins 
with  a  quote  mark.  This  message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  balanced  quote  marks. 


OPERAND  (xxxxxxxx  -  VALUE  N)  STRING  NOT  VALID 

Reason:  The  operator  command  operand  must  not  specify  a  character  string. 
This  message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand. 
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EBCOCMD9 


EBCOCNL1 


EBCOCNL2 


EBCOCNU 


EBCOCNL9 
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OPERAND  (xxxxxxxx  -  VALUE  n)  EXCEEDS  n  CHARACTERS 

Reason:  The  operator  Gommand  operand  must  not  be  more  than  n  characters. 
This  message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  a  valid  operand  length. 


INTERNAL  ERROR  TYPE  UNKNOWN 

Reason:  There  was  an  internal  error  in  the  operator  routine.  This  message  has  a 
MSGLVL  of  OPER. 

Action:  Contact  Computer  Associates  Technical  Support; 


userid  USER  CANCELED  BY  OPERATOR  REQUEST 

Reason:  The  CANCEL  command  has  abended  the  requested  user  subtask.  This 
message  has  a  MSGLVL  of  QPER. 

Action:  None. 

MUST  SPECIFY  ALL/USER/UID# 

Reason:  The  CANCEL  command  did  not  indicate  which  user  to  cancel.  This 
message  has  a  MSGLVL  of  OPER^ 

Action;  Re-issue  the  CANCEL  command  with  a  user  cormect  ID. 


NO  USERS  WERE  CONNECTED 

Reason;  The  CANCEL  command  did  not  find  any  users  in  this  region.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None. 

INTERNAL  ERROR  HAS  OCCURRED 

Reason:  The  CANCEL  command  had  an  internal  error.  This  message  has  a 
MSGLVL  of  OPER. 

Action;  Contact  Computer  Associates  Technical  Support. 
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EBCOLS1 1 


EBCOLS12 


EBCOLS14 


EBCOLSTl 


EBCOLST2 


EBCOLST3 


****  SUPPORT  TASK  USER  LIST 


Reason:  The  operator  list  command  is  processing  a  LIST  LTSERyALL  and  formd 
an  XMSSUBi=YES  subtask  with  active  control  blocks. 


Action:  None. 


****  SUPPORT  TASK  LOGON  QUEUE . 

Reason:  The  operator  list  command  is  processing  a  LIST  USER>ALL  and  found  a 
pending  logon  queue  with  active  control  blocks. 

Action:  None. 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  operator  list  command  is  processing  a  LIST  S,TABLE.  The  message 
displays  the  contents  of  the  E22XMCTR  table  that  is  currently  in  use. 

Action:  None. 


nn  vtamacb.terminalid  userid  appi  status  dbname 

Reason:  LIST  command  issued  for  a  cross-memory  region,  USER  display.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None.  This  is  an  informational  message. 

username  max  cur  hi  xms  vtm  status  fiag  asid  iongwt  version 

Reason:  LIST  command  issued  for  a  cross-memory  region,  STATUS  display. 
This  message  has  a  MSGLVL  of  GPER. 

Action:  None. 

DOES  NOT  SPECIFY  STATUS  USERS  OR  USER/UID# 

Reason:  The  LIST  command  did  not  indicate  what  users  are  to  be  listed.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command,  specifying  user  connect-IDs. 
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EBCOLST4 


EBCOLST5 


EBCOLST6 


EBCOLST7 


EBCOLST8 


EBCOLST9 


LIST  REQUEST  SPECIFIES  STATUS  AND  USER=,  UID#=,  USERS 
ACTIVE,  or  INACTIVE 


Reasoni:  The  operands  specified  with  the  STATUS  LIST  command  are  not  valid 
STATUS  operands.  This  message  has  a  MSGLVL  of  OPER. 

Action:  Re-issue  the  command  with  valid  operands. 


NO  USERS  WERE  CONNECTED 

Reason:  The  LIST  command  did  not  find  any  users  in  this  region.  This  message 
has  a  MSGLVL  of  OPER. 

Action:  None. 

SUBSYS  NOT  ON  SSCT  CHAIN 

Reason:  The  LIST  command  had  an  internal  error.  This  message  has  a  MSGLVL 
ofOPER. 


Action:  Contact  Computer  Associates  Technical  Support. 


XMEMCNTL  INVALID  ID  BLOCK 

Reason;  The  LIST  command  had  an  internal  error.  This  message  has  a  MSGLVL 
ofOPER. 

Action:  Contact  Computer  Associates  Technical  Support. 

RTUS  INVALID  ID  BLOCK 

Reason:  The  LIST  command  had  an  internal  error.  This  message  has  a  MSGLVL 
ofOPER. 

Action:  Contact  Computer  Associates  Technical  Support. 

xxxxxxxxxxx 

Reason:  LIST  command  display  of  database  status. 

Action:  None. 
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EBCOLSTIO 


EBCOMDF1 


EBCOMDF2 


EBCOMDF3 


EBCOMDF4 


EBCOMDF5 


xxxxxxxxxxx 

Reason:  LIST  command  display  of  XMSSUB  task  status. 

Action:  None. 

USERMAX  CHANGED 

Reason:  The  CHANGE  command  has  altered  the  USERMAX  parameter.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None. 

LONGWAIT  CHANGED 

Reason:  The  CHANGE  command  has  altered  the  LONGWAIT  parameter.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None. 


CANCEL  CHANGED 

Reason:  The  CHANGE  command  has  altered  the  CANCEL  parameter.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None. 

VTAMPASS  CHANGED 

Reason:  The  CHANGE  command  has  altered  the  VTAMPASS  parameter.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None. 

USERMAX  CHANGED 

Reason:  The  CHANGE  command  has  altered  the  USERMAX  parameter.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  None. 
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EBCOMDF6 


EBCOMDF9 


EBCOOPN2 


EBCOOPN3 


EBCOPR01 


EBCOPR08 


BAD  XMEMCNTL  FOUND 

Reason:  The  CHANGE  command  had  aniintemal  error.  This  message  has  a 
MSGLVLofOPER. 

Action:  Contact  Computer  Associates  Technical  Support. 


INVALID  VALUE 

Reason:  The  CHANGE  command  has  foimd  a  value  not  in  range.  This  message 
has  a  MSGLVL  of  OPER. 


Action:  Re-issue  the  command  with  a  valid  operand. 


SARVTAM  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  OPEN  corranand  attempted  to  open  the  SARVTAM  ACBy  the  text 
indicates  if  the  request  was  successful  or  not.  This  message  has  a  MSGLVL  of 
OPER. 

Action:  If  the  request  was  not  successful,  contact  Computer  Associates  Technical 
Support. 


SARVTAM  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  OPEN  conunand  has  attempted  to  open  the  SARVTAM  ACB>  the 
message  indicates  if  the  request  was  successful  or  not.  This  message  has  a 
MSGLVLofOPER. 


Action:  If  the  request  was  not  successful,  contact  Computer  Associates  Technical 
Support. 


OPER  FUNCT  xxxxxxxx  ADDRszXXXXXxxx  x.x  xx/xx/xx 

Reason;  The  operator  routine  was  loaded  at  the  address  indicated.  This  message 
has  a  MSGLVL  of  INFO. 

Action:  None. 


OPERATOR  FUNCTION  NOT  SUPPORTED 

Reason;  The  operator  routine  was  entered  and  there  was  no  MODIFY  or  STOP 
command  to  process.  This  message  has  a  MSGLVL  of  CRIT. 
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EBCOPR09 


EBCOQSH1 


EBCOQSH2 


EBCOQSH3 


EBCORSM1 


Action:  Contact  Computer  Associates  Technical  Support. 


AHACH  OF  COMMAND 

Reason:  The  OPEN  command  has  attempted  to  open  the  SARVTAM  ACB,  the 
message  indicates  if  the  request  was  successful  or  not.  This  message  has  a 
MSGLVLofCRIT. 


Action:  If  the  request  was  not  successful;  contact  Computer  Associates  Technical 
Support 


XMS  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  QUIESCE  command  has  attempted  to  QUIESCE  the  SARVTAM 
ACB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


SARVTAM  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  QUIESCE  command  has  attempted  to  QUIESCE  the  SARVTAM 
ACB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


RMOVTAM  xxxxxxxxxxxxxxxxxxxx 

Reason:  The  QUIESCE  command  has  attempted  to  QUIESCE  the  RMOVTAM 
ACB,  the  message  indicates  if  die  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  coimnand. 


XMS  xxxxxxxxxxxxxxxxxxxx 


Reason:  The  RESUME  command  has  attempted  to  RESUME  the  SARVTAM 
ACB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER. 
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EBCORSM2 


EBCORSM3 


EBCOSPNl 


EBCOSPN2 


Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful^  correct 
and  re-issue  the  command. 


SARVTAM  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  RESUME  command  has  attempted  to  RESUME  the  SARVTAM 
AGB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGEVLofOPER. 


Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful;  correct 
and  re-issue  the  command. 


RMOVfAM  xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  RESUME  command  has  attempted  to  RESUME  the  RMOVTAM 
AGB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


XMS  xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  SUSPEND  command  has  attempted  to  SUSPEND  the  SARVTAM 
AGB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER, 


Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


SARVTAM  xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  SUSPEND  coirunand  has  attempted  to  SUSPEND  the  SARVTAM 
AGB,  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
aMSGLVLofOPER, 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 
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EBCOSPN3 


EBCOSTPl 


EBCOSTP2 


EBCOSTP3 


EBCSFPOl 


VMOVlMAxxxxxxxxxxxxxxxxxxxxxxxxx 


Reason:  The  SUSPEND  command  has  attempted  to  SUSPEND  the  RMOVTAM 
AGB>  the  message  indicates  if  the  request  was  successful  or  not.  This  message  has 
a  MSGLVL  of  OPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


XMS  xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  SHUTDOWN  command  has  attempted  to  SHUTDOWN  the 
SARVTAM  ACB,  the  message  indicates  if  the  request  was  successful  or  not.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


SARVTAM  xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  SHUTDOWN  command  has  attempted  to  SHUTDOWN  the 
SARVTAM  ACB>  the  message  indicates  if  the  request  was  successful  or  not.  This 
message  has  a  MSGLVL  of  OPER. 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  command. 


RMOVTAM  xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  SHUTDOWN  command  has  attempted  to  SHUTDOWN  the 
RMOVTAM  ACB,  the  text  will  indicate  if  the  request  was  successful  or  not.  This 
message  has  a  MSGLVL  of  OPER^ 

Action:  Depends  on  the  actual  message.  If  the  request  was  not  successful,  correct 
and  re-issue  the  conunand. 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP 
INVALID  bik 

Reason:  A  CA-View  program  has  terminated>  and  a  dximp  was  generated.  In  this 
message,  Hfc  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  IFB,  SFB,  XFB,  or  DBB).  It  may  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program^  detected  the  problemi 


1 2-24  CA-View  System  Reference  Guide 


Diagnostic  and  Error  Messages 


EBCXFPOl 


EBCXMCOl 


EBCXMC02 


EBCXMC03 


Action:  Send  the  dump  to  Computer  Associates  Technical  Support.  Restart 
whatever  program  was  terminated.  If  the  problem  recurs,  run  SARDBASE 
VERIFY  on  the  database;  If  the  problem  persists,  contact  Computer  Associates 
Technical  Support  Technical  Support. 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP 
INVALID  bik 

Reason:  A  CA-View  program  has  terminated,  and  a  dump  was  generated.  In  this 
message,  Wfc  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  IFB,  SFB,  XFB>  er  DBB).  It  may  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program  detected  the  problem. 

Action:  Send  the  dump  to  Computer  Associates  Technical  Support.  Restart 
whatever  program  was  terminated.  If  the  problem  recurs,  run  SARDBASE 
VERIFY  on  the  database.  If  the  problem  persists,  contact  Computer  Associates 
Technical  Support. 


NON-MVS/XA  EXECUTION  NOT  ALLOWED 

Reason:  You  are  not  using  MVS/XA  or  MVS/ESA.  E22XMCIC  requires 
MVS/XA  or  MVS/ESA  to  work. 

Action:  Use  MVS/XA  or  MVS/ESA,  then  try  again. 


NON-CICS/XA  EXECUTION  NOT  ALLOWED 

Reason:  The  DFHPPT  or  RDO  definition  for  the  E22XMCIC  program  is  wrong. 
The  comment  indicates  what  specifically  was  found  to  be  in  error.  You  are 
possibly  not  using  Version  2.1.1  or  a  later  version  of  CICS.  E22XMCIC  requires 
Version  2.1.1  or  a  later  version  of  CICS  to  work. 

Action:  Correct  the  E22XMCIC  definition. 


E22XSTSK  NOT  ACTIVE 

Reason:  The  E22XSTSK  program  is  not  executing.  E22XMCIC  requires  the 
E22XSTSK  to  work.  E22XMCIC  ends.  E22CINIT,  which  starts  the  subtask,  was 
not  executing,  or  the  subtask  was  stopped. 

Action::  See  your  operations  administrator  for  more  information. 
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EBCXMC04 


EBCXMC05 


EBCXMC06 


EBCXMC07 


EBCXMC08 


EBCXMC09 


EBCXMC10 


INVALID  EBCXSCTL  BLOCK  FOUND  O 

Reason:  An  internal  error  occurred  in  E22XMGIC. 

Action:  Contact  Computer  Associates  Technical  Support. 

E22XMCIC  PROGRAM  MUST  BE  RUN  FROM  A  TERMINAL 

Reason:  E22XMCIC  is  designed  to  execute  attached  to  a  terminal.  E22XMCIC 
ends. 

Action:  Execute  E22XMCIC  from  a  terminal. 


TRANSACTION  COMAREA  WRONG  SIZE 

Reason:  An  internal  error  occurred  in  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 

COMAREA  ID  WRONG 

Reason:  An  internal  error  occurred  in  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 

EBCXSCTL  ADDRESS  CHANGED 

Reason:  An  internal  error  occurred  in  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 

E22CICUX  PROGRAM  NOT  FOUND 

Reason:  E22XMCIC  cannot  find  the  E22CICUX  program.  E22XMCIC  requires 
the  E22CICUX  to  work.  E22XMCIC  ends. 

Action:  Define  E22CICUX  for  CICS  RDO  (Resource  Definition  Online),  then  try 
again. 


USER  CONTROL  BLOCK  NOT  ACTIVE 


Reason:  An  internal  error  occurred  in  E22XMCIC. 
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EBCXMCn 


EBCXMC12 


EBCXMC13 


EBCXMC14 


EBCXMC16 


EBCXMC16 


Actioni  Contact  Computer  Associates  Technical  Support. 

USER  CONNECTION  LOST 

Reason:  E22XMCIC  cannot  find  the  user  connection  to  continue  the  session. 
E22XMCIC  ends. 

Action:  Restart  the  transaction; 

EBCXSUSR  ADDRESS  INVALID 

Reason:  An  internal  error  occurred  in  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 

EBCXSTSK  ABENDED.  SESSION  ABORTED 

Reason:  An  internal  error  occurred  in  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 


DATA  PASSED  EXCEEDS  102  BYTES 

Reason:  Parameter  data  larger  than  102  bytes  was  passed  to  E22XMCIC. 
Action:  Contact  Computer  Associates  Technical  Support. 


CICS  SESSION  TIMEOUT=  EXCEEDED 

Reason:  E22XMCIC  timed  out  waiting  for  the  cross-memory  region  to  respond. 

Action:  If  this  condition  occurs  frequently,  extend  the  parameter  TIMEOUT  in 
the  E22XMCTR  table,  if  possible. 


EBCXSTSK  STOPPED,  SESSION  ABORTED 

Reason:  E22XMCIG  found  that  E22XSTSK  is  shut  down.  E22XMCIC  ends. 
E22CINIT,  which  starts  the  subtask,  was  not  executing,  or  the  subtask  was 
stopped  or  failed. 

Action:  See  your  operations  administrator  for  more  information. 
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EBCXMC17 


EBCXMC18 


EBCXMC19 


EBCXMC20 


EBCXMC21 


EBCXMC90 


XMS  SESSION  EXCEEDED  LONGWAIT  O 

Reason:  Gross-memory  region  terminated  the  session  because  the  XMS  session 
exceeded  the  value  of  LONGWAIT  in  the  cross-memory  region. 

Action:  If  this  condition  occurs  frequently,  increase  the  value  of  LONGWAIT  in 
the  cross-memory  region  start  up  file. 


XMS  REGION  STOPPED 

Reason:  E22XMCIG  foimd  that  the  cross-memory  region  was  terminated. 
E22XMCIC  ends. 

Action:  Start  the  cross-memory  region,  then  try  again. 


SUBTASK  USERMAX  LIMIT  EXCEEDED 

Reason:  The  maximum  number  of  users,  specified  by  the  USERMAX  parameter 
of  the  E22XMGTR  macro  EBCXMOPT  has  been  readied,  and  no  more  sessions 
are  allbwed. 

Action:  Try  to  log  on  later^  or  increase  the  USERMAX  value  and  restart  the  GIGS 
region.  i 


LOGON  BLOCK  FULL 

Reason:  The  maximum  number  of  logons,  specified  in  the  E22XMGTR  macro 
EBGXMOPT,  has  been  reached. 

Action:  Try  to  log  on  later,  or  increase  the  value  and  restart  the  GIGS  region. 


RELEASE  DEPENDENT  PROGRAM  NOT  FOUND 

Reason:  The  DFHPPT  or  RDO  definition  for  the  GIGS  release  dependent 
program  is  missing.  The  program  name  varies  with  the  GIGS  release  we  are 
executing  imder.  E22G0330  would  be  used  for  GIGS  3.3:0,  E22G0212  would  be 
used  for  GIGS  2.1.2.  The  last  three  digits  indicate  the  GIGS  release. 

Action:  Gorrect  the  E22G0nnn  definition. 

RELEASE  DEPENDENT  PROGRAM  NOT  FOUND 

Reason:  The  E22XMCIC  application  program  has  abended. 
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EBCXMMOO 


EBCXMM01 


EBCXMM02 


EBCXMM03 


EBCXMM04 


EBCXMM05 


Action:  Contact  Computer  Associates  Technical  Support, 


ACTION  COMPLETED  WITH  NO  ERRORS 

Reason:  The  previous  operation  completed  successfully. 
Action:  None.  This  message  is  provided  for  reference  only. 


ACTION  COMPLETED,  ONE  LINE  MESSAGE  IN  BUFFER 


Reason:  An  internal  error  occurred  in  cross-memory  region. 
Action:  Contact  Computer  Associates  Technical  Support. 


REQUESTED  CONNECTION  ID  CANNOT  BE  FOUND 

Reason:  Your  session  has  been  lost.  This  condition  occurs  when  the  time  you 
specified  for  LONG  WAIT  is  exceeded  in  the  cross-memory  region,  the  cross¬ 
memory  region  is  shut  dovm  or  abnormally  ends,  or  an  operator  cancels  your 
session. 

Action:  Restart  your  session; 


CONNECTED  PROGRAM  ENDED  NORMALLY 

Reason:  You  have  ended  your  session,  and  the  cross-memory  session  completed 
without  errors. 

Action:  None.  This  message  is  provided  for  reference  only. 

CONNECTED  PROGRAM  ABENDED 

Reason:  Your  session  was  terminated.  The  cross-memory  session  failed. 

Action:  Check  the  job  log  of  the  cross-memory  region.  Restart  your  session. 


UNABLE  TO  SIGNON  -  ALREADY  AT  MAXUSERS 

Reason:  All  cross-memory  regions  are  at  the  maximum  user  limit. 
Action:  Start  more  cross-memory  regions  to  enable  more  users. 
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EBCXMM06 


EBCXMM07 


EBCXMM08 


EBCXMM09 


EBCXMM10 


EBCXMM1 1 


EBCXMM12 


UNABLE  TO  SiGNON  -  SIGNONS  ARE  SUSPENDED 

Reason:  Someone  suspended  the  cross-memory  region. 

Action:  Review  the  cross-memory  log  to  identify  who  suspended  the  region: 
Have  thati  person  release  the  cross-memory  region. 

RECONNECTION  REQUEST  FAILED 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

REQUESTED  SERVICE  IS  UNKNOWN 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 


UNABLE  TO  SIGNON  -  SYSTEM  IS  QUIESCING 

Reason:  The  cross-memory  region  is  being  terminated  and  logons  are  no  longer 
accepted. 

Action:  Review  the  cross-memory  log  to  identify  who  terminated  the  cross¬ 
memory  region.  Start  the  cross-memory  region. 


REQUESTED  ITEM  IS  NOT  HANDLED  BY  SERVICE 

Reason:  An  internal  error  occurred  in  cross-memory. 
Action:  Contact  Computer  Associates  Technical  Support. 


UNABLE  TO  SIGNON  -  SYSTEM  IN  STARTUP 

Reason:  The  cross-memory  region  has  not  finished  initializing. 

Action:  Wait  for  cross-memory  to  finish  initializing,  then  retry  your  request. 


CONNECTION  ID  IS  ALREADY  DISCONNECTED 

Reason:  An  internal  error  occurred  in  cross-memory. 
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EBCXMM13 


EBCXMM14 


EBCXMM15 


EBCXMM16 


EBCXMM17 


EBCXMM18 


Action:  Gontact  Computer  Associates  Technical  Support. 

GETMAiN  FAILURE  FOR  USER  TABLE  ENTRY 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

TIMEOUT  WAITING  FOR  PROGRAM  RESPONSE 

Reason:  The  last  request  exceeded  the  time-out  value  in  the  E22XMCTR  table 
entry  for  this  transaction. 

Action:  If  too  many  of  these  failures  occur,  review  and  extend  the  TIMEQUT 
parameter. 

CROSS-MEMORY  ASCB  CANNOT  BE  FOUND 

Reason:  An  internal  error  occurred  in  CROSS-MEMORY. 

Action:  Contact  Computer  Associates  Technical  Support. 

DISCONNECTION  REQUEST  FAILED 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

GETMAIN  FAILURE  FOR  COMMUNICATION  BLOCK 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action;  Contact  Computer  Associates  Technical  Support. 

NO  ACTIVE  CROSS-MEMORY  SYSTEM  AVAILABLE 

Reason:  A  cross-memory  region  must  be  executing  to  log  on. 

Action;  Start  a  cross-memory  region,  then  try  to  log  on  again. 
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EBCXMM19 


EBCXMM20 


EBCXMM21 


EBCXMM22 


EBCXMM23 


EBCXMM24 


EBCXMM25 


CROSS-MEMORY  CONTROL  BLOCK  IS  INVALID 


Reason:  An  internal  error  occurred  in  cross-memory. 
Action:  Contact  Computer  Associates  Technical  Support. 


CONNECTION  ALREADY  ESTABLISHED 

Reason:  The  connect  identifier  you  specified  is  already  in  use. 

Action:  Make  sure  E22CICUX  is  generating  a  unique  connect  identifier  for  each 
user. 


PARAMETER  LIST  PASSED  IS  INVALID 

Reason:  An  internal  error  occurred  m  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

GETMAIN  FAILURE  FOR  SIGNON  REQUEST  BLOCK 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

USER  TABLE  ENTRY  IS  INVALID 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action;  Contact  Computer  Associates  Technical  Support. 

SIGNON  QUEUE  ELEMENT  HAS  INVALID  FORMAT 

Reason;  An  internal  error  occxurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

AHACH  OF  REQUESTED  PROGRAM  FAILED 

Reason;  An  mtemal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 
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EBCXMM26 


EBCXMM27 


EBCXMM28 


EBCXMM29 


EBCXMM30 


EBCXMTOl 


EBCXMT02 


USER  TABLE  CANNOT  BE  FOUND 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

GETMAIN  FAILURE  FOR  SUBTASK  PARAM  LIST 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

XMSRETMG  -  REQUESTED  CODE  IS  UNKNOWN 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

ONLY  PARTIAL  TEXT  MOVED 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

XMS  INTERFACE  CONTROL  BLOCK  INVALID 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 

xxxxxxxx  -  LOGON  REQ  -  xxxxxxxx 

Reason:  A  request  to  log  onto  XMSSUB  has  been  received. 
Action:  None,  the  logon  is  being  processed. 

XXXXXXXX  -  INPUT  ISQ  -  xxxxxxxx 

Reason:  An  input  request  has  been  received  from  the  terminal. 
Action:  None,  the  request  is  being  processed. 
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EBCXMT03 


EBCXMT04 


EBCXMT05 


EBCXMT06 


EBCXMT07 


EBCXMT08 


EBCXMT09 


E22XSTSK  NOT  ACTIVE  O 

Reason:  The  E22XSTSK  program  is  not  executing.  XMSSUBc YES  is  required  in 
the  cross-memory  address  space,  or  the  cross-memory  region  is  not  active. 

Action:  Verify  that  XMSSUB=YES,  and  that  the  cross-memory  region  is  active. 

INVALID  EBCXSCTL  BLOCK  FOUND 

Reason:  An  internal  error  occurred  in  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 


E22XMCIC  TERMINAL  NOT  SUPPORTED 

Reason:  The  terminal  t3rpe  is  invalid. 

Action;  Verify  that  the  terminal  type  is  3270,  or  a  PC  emulator. 

TRANSACTION  COMAREA  WRONG  SIZE 

Reason:  An  internal  error  occurred. 

Action:  Contact  Computer  Associates  Technical  Support. 

COMAREA  ID  WRONG 

Reason;  An  internal  error  occurred. 

Action;  Contact  Computer  Associates  Technical  Support. 

EBCXSCTL  ADDRESS  CHANGED 

Reason;  An  internal  error  occmred. 

Action:  Contact  Computer  Associates  Technical  Support. 

xxxxxxxx  PROGRAM  NOT  FOUND 

Reason;  The  specified  user  connection  exit  was  not  found. 
Action;  Place  the  user  exit  in  the  LOADLIB; 
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USER  CONTROL  BLOCK  NOT  ACTIVE 


Reason;  An  internal  error  occurred  in  E22XMCIC. 


Action:  Contact  Computer  Associates  Technical  Support. 


EBCXMTl  1  USER  CONNECTION  LOST 

Reason:  E22XMCIC  carmotfind  the  user  connection  to  continue  the  session. 
E22XMCIC  ends. 

Action:  Restart  the  transaction. 


EBCXMTl  2  EBCXSUSR  ADDRESS  INVALID 

Reason:  An  internal  error  occurred  in  E22XMCIC. 
Action:  Contact  Computer  Associates  Technical  Support. 


EBCXMTl  3 

u 


EBCXSTSK  ABENDED,  SESSION  ABORTED 

Reason:  An  internal  error  occurred  in  E22XMCIC. 
Action:  Contact  Computer  Associates  Technical  Support. 


EBCXMTl  4  DATA  PASSED  EXCEEDS  1 02  BYTES 

Reason:  Parameter  data  larger  than  102  bytes  was  passed  to  E22XMCIC. 

Action:  Contact  Computer  Associates  Technical  Support. 

EBCXMTl  5  TSO  SESSION  TIMEOUT  EXCEEDED 

Reason:  A  time-out  occurred  waiting  for  the  cross-memory  region  to  respond. 

Action:  If  this  condition  occurs  frequently,  increase  the  parameter  TIMEOUT  in 
the  E22XMCTR  table,  if  appropriate. 
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EBCXMT16 


EBCXMT17 


EBCXMT18 


EBCXMT20 


EBCXMT21 


EBCXSTSK  STOPPED,  SESSION  ABORTED 


Reason:  E22XMGIG  f oxmd  that  E22XSTSK  is  shut  down:  E22XMGIG  ends . 
E22GINn’,  which  starts  the  subtask,  was  not  executing,  or  the  subtask  was 
stopped  or  failed. 

Action:  See  your  operations  administrator  for  more  informationi 


XMS  SESSION  EXCEEDED  LONGWAIT 

Reason:  Gross-memory  terminated  the  session  because  the  XMS  session 
exceeded  the  value  of  LONGWAIT  in  the  cross-memory  region. 

Action:  If  this  condition  occurs  frequently,  increase  the  value  of  LONGWAIT  in 
the  cross-memory  startup  file. 


XMS  REGION  STOPPED 

Reason:  E22XMGIG  foxmd  that  the  cross-memory  region  was  terminated. 
E22XMGIG  ends. 

Action:  Start  the  cross-memory  region,  then  try  again. 


INVALID  XMEMCNTL  FOUND 

Reason:  The  region  control  block  was  invalid,  or  at  the  incorrect  release  level  for 
this  user  connection. 

Action:  Gheck  the  status  of  the  cross-memory  regions,  as  they  may  have 
tenninated. 

NO  ACTIVE  XMS  REGION  AVAILABLE 

Reason:  There  was  no  active  cross-memory  region  available. 

Action:  Start  up  a  cross-memory  region.  It  must  have  the  default  SUBSYS= 
value,  and  must  specify  XMSSliJB=YES.  See  the  CA-View  Installation  Guide  for 
details. 
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EBCXMT24 


EBCXMT25 


EBCXMT26 


EBCXMT27 


EBCXMT28 


EBCXMT29 


E22XSTSK  USER  MAX  EXCEEDED 

Reason:  The  USERMAX  value  was  exceeded. 

Action:  If  possible,  increase  the  parameter  value. 

CANNOT  FIND  CROSS-MEMORY  REGION 

Reason:  No  cross-memory  region  with  the  default  SUBSYS=  value  has  been 
started. 

Action:  Start  up  a  cross-memory  region  with  the  default  SUBSYS=  value. 

XMSSUB=YES  SUPPORT  NOT  ACTIVE 

Reason:  No  cross-memory  region  with  XMSSUB=YES  value  is  active. 
Action:  Start  up  a  cross-memory  region  with  XMSSUBi=YES. 

SUPPORT  SUBTASK  NOT  ACTIVE 

Reason:  A  cross-memory  region  with  XMSSUB» YES  has  terminated,  or  the 
subtask  has  failed. 

Action:  Start  up  a  cross-memory  region  with  XMSSUB=YES. 

NON-MVS/XA  EXECUTION  NOT  ALLOWED 

Reason:  The  application  interface  must  be  in  31-bit  mode. 

Action:  Contact  Computer  Associates  Technical  Support. 

NON-TSO/XA  EXECUTION  NOT  ALLOWED 

Reason:  The  application  interface  must  be  in  31-bit  mode. 

Action:  Contact  Computer  Associates  Technical  Support. 
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EBCXMT30 


EBCXMT31 


EBCXMT32 


EBCXMT33 


EBCXMT34 


EBCXMT35 


LOGON  BLOCKS  FULL  KJ 

Reason:  All  user  logon  blocks  are  in  use.  The  system  may  be  having  problems 
logging  on  a  user  and  allithe  logon  blocks  are  full.  Try  again  later. 

Action:  None. 


NO  ACTIVE  XMS  REGION  FOUND 

Reason:  The  cross-memory  region  may  have  failed. 

Action:  Contact  Computer  Associates  Technical  Support. 

INVALID  XMEMCNTL  FOUND 

Reason:  An  internal  error  has  occurred. 

Action:  Contact  Computer  Associates  Technical  Support. 

BAD  IMS  TERMINAL  TYPE 

Reason:  The  operand  of  the  IMS/DC  transaction  does  not  specify  a  valid 
terminal  type. 

Action:  Re-enter  the  transaction  with  a  proper  operand. 


BAD  TERMINAL  OPTIONS 

Reason:  The  operand  of  the  IMS/DC  transaction  does  not  specify  a  valid 
terminal  option. 

Action:  Re-enter  the  transaction  with  a  proper  operand. 


IMS/DC  BAD  PSB  RETURN  CODE 

Reason:  An  imexpected  return  code  was  received  from  IMS/DC. 
Action:  Contact  Computer  Associates  Technical  Support. 
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EBCXMT39 


EBCXMT40 


EBCXMT41 


EBCXMT44 


EBCXSCOO 


REQUIRED  PROGRAMS  MISSING  FROM  STEPLIB 


Reason:  The  E22XMTSO  program  has  checked  and  fomd  that  one  or  more 
required  programs  cannot  be  loaded  from  the  STEPLIBlThe  EBCXMTM  message 
will  be  displayed  indicating  the  missing  programs  that  must  be  available. 

Action:  Copy  the  required  programs  to  the  STEPLIB>  then  restart  the 
mitiali2ation  process. 


USER  EXIT  DENIED  ACCESS 

Reason:  A  non-zero  return  code  was  received  from  the  user  connection  exit. 
Action:  Contact  Computer  Associates  Technical  Support. 


IMS/DC  CALL  (func)  FAILED  RC=rc.  SESSION  TERMINATED 

Reason:  The  indicated  IMS/DC  function  call  failed  with  IMSIO_STAT  set  to  the 
given  return  code.  Check  the  appropriate  IMS  manual  for  function  and  return 
code  meanings. 

Action:  If  the  cause  of  the  problem  caimot  be  determined,  contact  Computer 
Associates  Technical  Support . 


xxxxxxxx  yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy  not  found 
ON  STEPLIB 

Reason:  The  E22XMTSO  program  has  checked  and  found  one  or  more  required 
programs  that  cannot  be  loaded  from  the  STEPLIB. 

Action:  Copy  the  required  programs  to  the  STEPLIB,  then  restart  the 
initialization  process. 


QUEUE  ALLOCATED  #  1ST=  7sASIZE=s/ze  FREE=free 
EBCXSCTL=xscf/  EBCXSUSR- 1  SJ=x$user  XMPCSGPR- 1  -pcsgpr 

Reason;  This  error  message  is  displayed  for  debugging  purposes. 

In  this  message,  #,  1st,  size,free,  xsctl,  xsuser,  and  pcsgpr  represent  additional 
parameter  values  provided  for  further  reference. 

Action:  None.  This  is  an  informational  message. 
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EBCXSSTl 


EBCXSST2 


EBCXSST3 


EBCXSTOl 


NO  USER  TABLE  —  RECOVERY-  Sn  -—SUBTASK  WAIT— - 

Reason:  E22XSTSK  abnormally  ended.  In  this  message,  n  represents  an 
additional  parameter  value  provided  for  further  reference. 

Action:  None.  E22XSTSK  attempts  to  automatically  restart  itself. 


PSW=#A  #B  #C  #D  E22XSTSK  EPA=#E 

Reason:  E22XSTSK  abnormally  ended.  In  this  message,  ,#A,  #B>  #G,  #D;  and  #E 
represent  additional  parameter  values  provided  for  further  reference. 

Action:  None.  E22XSTSK  attempts  to  automatically  restart  itself. 


GPR  0-3  #A  #B  #C  #D 
GPR  4-7  #A  #B  #C  #D 
GPR8-n  #A#B#C#D 
GPR  12-15  #A#B#C#D 

Reason:  E22XSTSK  abnormally  ended.  In  this  message,  #C,  and  #D 

represent  additional  parameter  values  provided  for  further  reference. 

Action:  None.  E22XSTSK  attempts  to  automatically  restart  itself. 


SUBTASK  E22XSTSK  ACTIVE  ADDR=#  1 .6  M/D/Y  H.M 
AWTO  FUNCT  E22AWTO  ACTIVE  ADDR=#  1 .5  M/D/Y  HM 
QMSG  FUNCT  E22QMSG  ACTIVE  ADDR=#  1 .5  M/D/Y  H.M 
SUBT  ETXR  E22XSETX  ACTIVE  ADDR=#  1 .6  M/D/Y  H.M 
SUBT  ESTAE  E22XSSTA  ACTIVE  ADDR=#  1 .5  M/D/Y  H.M 
3270  DEV  E22D3270  ACTIVE  ADDR=#  1.6  M/D/Y  H.M 
XMS  MSGS  E22XMMSG  ACTIVE  ADDR=#  1 .5  M/D/Y  H.M 
XMS  CNTRL  E22XMCTR  ACTIVE  ADDR=#  1 .5  M/D/Y  H.M 
SRVTRAN=XM  1 4  DEST=XM1 4 


Reason:  This  error  message  is  displayed  for  debugging  purposes. 


In  this  message,  #  represents  an  actual  address.  M,  D,  and  Y  represent  the  month, 
day,  and  year,  respectively.  H  and  M  represent  the  hour  and  minutes. 


Action:  None.  This  message  is  provided  for  reference  only. 
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EBCXST02 


EBCXST03 


EBCXST04 


EBCXST05 


EBCXST06 


EBCXST20 


xxxxxxxx  XMS  LOGON  xxxxxxx  HIGH  LEVELQUAL 
xxxxxxxx 

Reason:  The  user  is  being  logged  on  to  the  cross-memory  address  space. 
Action:  None. 


XXXXXXXX  CICS  TIMEOUT  POSTED  TO  XMS 


Reason:  The  user  has  timed  out>  the  session  imdergoes  clean-up  processing. 


Action:  None. 

E22XSOPR  SUBTASK  ATTACHED 

Reason:  The  E22XSOPR  (GIGS  operator  subtask)  has  been  attached  to  provide 
the  GIGS  OPERATOR  interface. 

Action:  None. 


E22XSOPR  SUBTASK  DETACHED 

Reason:  The  E22XSOPR  (GIGS  operator  subtask)  has  been  detached.  This 
normally  occurs  only  when  the  subtask  is  shutting  down. 

Action:  None. 

E22XSOPR  SUBTASK  DETACH  (failed) 

Reason:  The  E22XSOPR  (GIGS  operator  subtask)  has  failed  to  stop.  This  operator 
subtask  may  have  previously  failed. 

Action:  Gontact  Gomputer  Associates  Technical  Support. 


CROSS-MEMORY  VIEW  RETRIEVAL  HAS  ABENDED 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Gontact  Gomputer  Associates  Technical  Support. 
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EBCXST21 


EBCXST22 


EBCXST24 


EBCXST25 


EBCXST27 


EBCXST28 


NO  CROSS-MEMORY  SYSTEM  REGION  ACTIVE,  SUBSYS=name 

Reason:  You  tried  to  log  onto  a  subsystem  on  which  a  cross-memory  region  is 
not  initialized  and  active.  In  this  message,  name  represents  the  name  assigned  to 
the  subsystem^ 

Action:  Initialize  a  cross-memory  region  on  the  subsystem,  then  try  to  log  on 
again. 


INSUFFICIENT  MEMORY  FOR  CROSS-MEMORY  OPERATION 

Reason:  Not  enough  memory  is  allocated  to  cross-memory,  or  the  USERMAX 
parameter  is  set  too  high. 

Action:  Allocate  more  memory  to  cross-memory  and  reduce  the  number  of  users 
assigned  to  the  USERMAX  parameter. 


FREE  OF  LOCAL  MEMORY  FAILED  -  SESSION  ENDED 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 


USER  CONNECTION  ID  IS  INVALID 

Reason:  The  coimection  identifier  modified  by  the  E22C1CUX  user  exit  is 
incorrect  or  invalid. 

Action:  Verify  that  the  connection  identifier  modified  by  the  E22CICUX  user  exit 
is  valid. 


CROSS-MEMORY  VIEW  HAS  TERMINATED  NORMALLY  -  THIS 
SESSION  IS  ENDED 

Reason:  Your  session  ended  with  no  errors. 

Action:  None.  This  message  is  provided  for  reference  only. 


OUTPUT  SCREEN  EXCEEDS  TERMINAL  BUFFER  SIZE  -  SESSION 
ENDED 

Reason:  An  internal  error  occurred  in  cross-memory. 
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EBCXST29 


EBCXST30 


EBCXST31 


EBCXST32 


EBCXST33 


Action:  Contact  Computer  Associates  Technical  Support. 


TRANSACTION  TO  DATABASE  INDEX  NAME  TABLE  IS  EMPTY  - 
SESSION  ENDED 


Reason:  Yoxor  E22XMCTR  table  contains  zero  entries. 


Action:  Rebuild  the  E22XMCTR  table  with  at  least  one  transaction  definition. 

INVALID  CROSS-MEMORY  CONTROL  BLOCK  FOUND  (XMCT)  - 
CONTACT  COMPUTER  ASSOCIATES  CORP. 

Reason:  An  internal  error  occurred  in  cross-memory. 

Action:  Contact  Computer  Associates  Technical  Support. 


CROSS-MEMORY  ADDRESS  SPACE  NO  LONGER  ACTIVE 

Reason:  The  cross-memory  region  is  terminated. 

Action:  None.  This  message  is  provided  for  reference  only. 


DATABASE  INDEX  NAME  NOT  FOUND  FOR  TRANSACTION  - 
SESSION  ENDED 

Reason:  The  entry  for  this  transaction  does  not  have  a  valid  database  name. 

Action:  Check  the  entry  for  the  transaction  to  ensure  the  database  name  is 
correct.  Correct  the  database  name  if  necessary,  then  try  again.  If  the  problem 
persists,  contact  Computer  Associates  Technical  Support. 


MAXIMUM  SESSIONS  IN  USE  -  SESSION  ENDED 

Reason:  The  cross-memory  session  you  are  trying  to  initiate  exceeds  the 
maximum  number  allowed  in  the  E22MCTR  table.  You  cannot  initiate  new 
sessions. 

Action:  Terminate  cross-memory  sessions,  then  try  again: 
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EBCXST34 


EBCXST35 


EBCXST40 


EBCXST41 


EBCXST42 


EBCXST43 


DATABASE  INDEX  NAME  NOT  FOUND  IN  TABLE  -  SESSION  ENDED 


Reason:  The  E22XMGTR  table  does  not  contain  the  database  index  name  you 
specified,  and  so  you  are  denied  access  to  the  table. 

Action:  Add  an  entry  to  the  E22XMCTR  table  for  the  database  you  want  to 
specify. 


PROGRAM  NAME  NOT  FOUND  IN  TABLE  ENTRY,  VERIFY  VERSION 
OF  MACRO  USED  IN  TABLE  ASSEMBLE 

Reason:  E22XMCTR  was  assembled  with  the  SARXMTRM  macro  from  a 
previous  release  of  a  Computer  Associates  product. 

Action:  Assemble  the  table  again  with  the  current  macro  library. 


ERROR  DURING  SIGNON  - 

Reason:  An  error  occurred  in  cross-memory. 

Action:  Review  the  error  message  displayed  after  this  error  message  for  more 
information  about  the  cause.  Take  action  based  on  the  contents  of  the  second 
error  message. 


CROSS-MEMORY  FIND  ERROR  - 

Reason:  An  error  occurred  in  cross-memory. 

Action:  Review  the  error  message  displayed  after  this  error  message  for  more 
information  about  the  cause.  Take  action  based  on  the  contents  of  the  second 
error  message. 


CROSS-MEMORY  GET  BUFFER  ERROR  - 

Reason:  An  error  occurred  in  cross-memory. 

Action:  Review  the  error  message  displayed  after  this  error  message  for  more 
infojmation  about  the  cause.  Take  action  based  on  the  contents  of  &e  second 
error  message. 


CROSS-MEMORY  PUT  BUFFER  ERROR  - 

Reason;  An  error  occurred  in  cross-memory. 
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EBCXST44 


EBCXST45 


EBCXST50 


SARACIOl 


SARACI02 


Action:  Review  the  error  message  displayed  after  this  error  message  for  more 
information  aboutthe  cause.  Take  action  based  on  the  contents  of  the  second 
error  message. 

CROSS-MEMORY  GET  COMAREA  INFO  ERROR  - 

Reason:  An  error  occurred  in  cross-memory. 

Action:  Review  the  error  message  displayed  after  this  error  message  for  more 
information  about  the  cause.  Take  action  based  on  the  contents  of  the  second 
error  message. 


CROSS-MEMORY  POST  ERROR  - 

Reason:  An  error  occurred  in  cross-memory. 

Action:  Review  the  error  message  displayed  after  this  error  message  for  more 
information  about  the  cause.  Take  action  based  on  the  contents  of  the  second 
error  message. 

XMS  SUBTASK  POSTED  XSC_SUBF=#A  XSC.ECBl  =#B 

Reason:  This  error  message  is  a  trace  message  to  the  indicated  logic  flow.  In  this 
message  #A  and  #B  represent  additional  parameter  values  provided  for  further 
reference. 

Note:  This  message  appears  only  if  trace  messages  are  requested. 

Action:  None.  This  message  is  provided  for  reference  only. 


UNABLE  TO  SET  SVC  SCREENING  FOR  product 

Reason:  The  SVC  screening  product  must  be  initialized,  it  could  not  be  foimd. 
Action:  Verify  the  SVC  screening  product  is  available. 


ACIF  LOAD  MODULE  NOT  FOUND  FOR  product 

Reason:  The  APKACIF  module  could  not  be  foimd  in  your  IBM  target  libraries. 

Action:  Verify  that  the  STEPLIB  statement  is  concatenated  to  CAICAILIB,  or 
verify  that  they  are  both  in  the  LNKLST. 
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SARACI03 


SARACI04 


SARACI05 


SARACI06 


SARAC107 


SARACI08 


SARACI09 


INVALID  INITIALIZATION  PARAMETER  keyword=parm  FOR 
product 

Reason:  A  keyword  was  misspelled  in  the  //PRTnnn  statement. 

Action:  Correct  the  keyword,  tiien  resubmit  the  job. 

INVALID  INITIALIZATION  VALUE  keyword=parm  FOR  product 

Reason:  A  ke5nvord  was  assigned  an  invalid  value. 

Action:  Correct  the  keyword,  then  resubmit  the  job. 

UNDEFINED  DATA  BASE  HIGH-LEVEL  NAME  FOR  product 

Reason:  The  database  name  specified  as  the  NAME  statement  was  not  found. 
Action:  Correct  the  name,  then  resubmit  the  job. 

INDEX  CONTROL  MEMBER  member  NOT  FOUND  FOR  product 

Reason:  Either  the  index  member  name  was  misspelled  or  it  down  not  exist. 
Action:  Correct  the  name,  then  resubmit  the  job. 

ERROR  OPENING  SARENDEX  DD  STATEMENT  FOR  product 

Reason:  There  is  a  media  problem; 

Action:  Verify  that  the  volume  is  online  and  functioning  properly. 

DATA  BASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  database  is  not  at  the  appropriate  level. 

Action:  Verify  that  your  database  level  (set  with  the  SARDBASE  utility)  is 
correct,  then  rerun  SARDBASE  if  necessary. 

ERROR  FROM  ACIF  FOR  product,  RC^return  code 

Reason:  An  error  came  back  from  ACIF,  the  return  code  is  provided. 
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SARACnO 


SARACI22 


SARACI24 


SARACTOl 


SARBCB02 


Action:  Qieck  the  IBM  documentation  on:  APKACIF  messages. 


producf  AUTHORIZATION  FAILED  FOR  USERLIB  userlib 

Reason:  The  RACROUTE  request  returned  with  an  error  code  indicating  that  the 
security  rules  do  not  permit  access  to  the  userlib. 

Action:  Ensure  the  userlib  is  correctly  specified  and/or  change  the  security  rules 
for  it 


product  PROCESSING  jobname(jobid)  jobdsn 

Reason:  This  message  is  informational. 

Action:  None. 

NO  MORE  SPACE  IN  DATA  BASE  -  REPLY  R  (RETRY)  T 
(TERMINATE) 

Reason:  There  is  not  enough  space  in  the  database  to  perform  the  archival. 

Action:  Reply  with  either  an  R  to  re-attempt  archival,  or  a  T  to  terminate: 

1.  Run  the  SARDBASE  program  to  add  more  space  to  the  database,  or  manually 
delete  SYSOUT  grovys  to  free  up  space  while  the  archival  task  waits.  After 
you  make  more  space  available,  reply  R  to  have  the  archival  task  retry  its 
archival  with  the  additional  space. 

2.  Reply  T  to  terminate  the  archival  task. 

I/O  ERROR  UPDATING  ACCOUNTING  DATASET 

Reason:  An  1/ O  error  occurred  at  job  initiation  when  an  attempt  was  made  to 
update  the  job  accoimting  data  set. 

Action:  If  this  error  persists,  recreate  the  job  accounting  data  set. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 


Action:  Consult  with  your  security  administrator  or  system  programming  group 
to  determine  the  reason  why  the  authorization  was  not  provided. 
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BUNDLE  SUCCESSFULLY  PRINTED 

Reason:  The  bundle  was  successfully  produced. 
Action:  None. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  backup  cycle  deleting  the  SYSOUT  group  prior  to 
completion  of  the  bundling  process  or  the  manual  deletion  of  the  SYSOUT  group 
by  using  the  online  retrieval  facility  or  batch  retrieval  facility  (SARBCH). 

Action:  Verify  the  existence  of  all  SYSOUT  groups,  change  or  omit  any 
nonexistent  SYSOUT  groups,  then  resubmit  the  btmdle  reprint  request. 


BUNDLE  ID  NOT  SPECIFIED 

Reason:  The  BID  parameter  was  not  specified  and  is  required  on  the  control 
statement. 

Action:  Add  the  BID  parameter  to  the  /BPRINT  control  statement,  then 
resubmit  the  bundle  reprint  request. 


BUNDLE  CONTENTS  NOT  SPECIFIED 

Reason:  The  BCONT  parameter  was  not  specified  and  is  required  on  the  control 
statement. 

Action:  Add  the  BCONT  parameter  to  the  /BPRINT  control  statement,,then 
resubmit  the  bundle  reprint  request. 


INVALID  SPECIFICATION  OF  BCONT  PARAMETER  NEAR 
POSITION  xxxx 

Reason:  The  syntax  of  the  BCONT  parameter  is  invalid.  This  is  normally  caused 
by  null  parameter  data,  invalid  character  data,  or  excessive  parentheses  or 
commas. 

Action:  Review  the  syntax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  bxmdle  reprint 
request. 
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DISTRIBUTION  IDENTIFIER  xxxxxxxx  lOO  LONG  IN  BCONT 
PARAMETER 

Reason:  The  specified  distribution  identifier  contains  too  many  characters.  The 
distribution  identifier  on  the  BCONT  parameter  must  be  from  1  to  8  characters  in 
length. 

Action:  Review  the  syntax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  bimdle  reprint 
request. 


REPORT  IDENTIFIER  xxxxxxxxxxxxlOO  LONG  IN  BCONT 
PARAMETER 

Reason:  The  specified  report  identifier  contains  too  many  characters.  The  report 
identifier  on  the  BCONT  parameter  must  be  from  1  to  12  characters  in  length. 

Action:  Review  the  S5mtax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  bundle  reprint 
request. 


REPORT  IDENTIFIER  xxxxxxxxxxxx  NOT  DEFINED  TO  BUNDLE 
xxxxxxxxxx  IN  BCONT  PARAMETER 

Reason:  The  specified  report  identifier  was  not  defined  to  the  specified  bimdle  in 
the  CA-Deliver  database  because  the  report  identifier  was  incorrectly  named,  was 
deleted  from  the  bundle  prior  to  completion  of  the  bundle  reprint  request>  or  was 
never  defined  to  the  bundle. 

Action:  Review  the  bimdle  definition  in  CA-Deliver  Delivery,  change  or  delete 
the  report  identifier  specification,  then  resubmit  the  bundle  reprint  request. 


DISTRIBUTION  IDEhfTIFIER  xxxxxxxx  NOT  DEFINED  TO  REPORT 
xxxxxxxxxxxx  IN  BCONT  PARAMETER 

Reason:  The  specified  distribution  identifier  was  not  defined  to  specified  report 
in  the  CA-Deliver  database  because  the  distribution  identifier  was  incorrectly 
named,  was  deleted  from  the  report  prior  to  completion  of  the  bundle  reprint 
request,  or  was  never  defined  to  the  report. 

Action:  Review  the  bundle  definition  in  CA-Deliver,  change  or  delete  the 
distribution  identifier  specification,  then  resubmit  the  bundle  reprint  request. 
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GENERATION  xxxxx  TOO  LONG  IN  BCONT  PARAMETER  W 

Reason;  The  specified  generation  contains  too  many  characters.  The  generation 
field  in  the  BCONT  parameter  must  be  1  to  5  characters  in  length. 

Action;  Review  the  syntax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  bundle  reprint 
request. 


GENERATION  xxxxx  INVALID  IN  BCONT  PARAMETER 

Reason;  The  specified  generation  contains  invalid  characters.  The  generation: 
field  in  the  BCONT  parameter  specifies  an  absolute  or  relative  numeric  value. 

Action;  Review  the  syntax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement  correct  the  parameter  specification,  then  resubmit  the  bimdle  reprint 
request. 


SEQUENCE  NUMBER  xxxxx  TOO  LONG  IN  BCONT  PARAMETER 

Reason;  The  specified  sequence  number  contains  too  many  characters.  The 
sequence  nmnber  field  in  the  BCONT  parameter  must  be  1  to  5  characters  in 
length. 

Action;  Review  the  syntax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  bundle  reprint 
request. 


SEQUENCE  NUMBER  xxxxx  INVALID  IN  BCONT  PARAMETER 

Reason;  The  specified  sequence  number  contains  invalid  characters.  The 
sequence  number  field  in  the  BCONT  parameter  specifies  an  absolute  or  relative 
numeric  number. 


Action;  Review  the  syntax  of  the  BCONT  parameter  on  the  /BPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  bundle  reprint 
request. 


I/O  error  message 

Reason;  1/ O  operation  against  the  CA-Deliver  database  failed.  The  error 
message  can  range  from  a  severe  error  condition  such  as  physical  or  logical  I/O 
error  to  non-severe  error  condition  such  as  record  notfoimd  or  database  not 
defined. 
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Action:  If  a  database  not  found  message  is  produced,  verify  that  the  EXPRESS 
initialization  parameter  references  the  correct  database.  If  a  record  not  found 
message  is  produced,  the  respective  identifier  may  have  to  be  removed  from  the 
btmdle  reprint  request.  Consult  the  CA-Deliver  documentation  to  remedy  severe 
error  conditions. 


USER  IS  NOT  AUTHORIZED  TO  PRINT  REPORT  TO  THIS 
DESTINATION 

Reason:  The  SARDSTUX  user  exit  did  not  allow  the  bundle  to  be  printed  to  its 
respective  destination. 

Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reason  why  the  authorization  was  not  provided. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  specified 
SYSOUT  group. 

Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reasons  why  the  authorization  was  not  provided. 


ID  MISSING 

Reason:  The  ID  parameter  was  incorrectly  specified  without  a  SYSOUT  identifier 
and  is  required  on  the  control  statement. 

Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
changed,  then  resubmit  the  print  request 


SYSOUT  SUCCESSFULLY  CHANGED 

Reason:  The  SYSOUT  group  was  successfully  updated  with  the  requested 
information. 

Action:  None.  This  is  an  informational  message. 
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REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  amisspelled  SYSOUT  identifier,  the  SYSOUT  group  was 
manually  deleted  from  the  online  or  batch  retrieval  facilities,  or  the  backup  cycle 
deleted  the  SYSOUT  group  prior  to  the  completion  of  the  change  process. 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID)> 
generation  number  (GEN),  and/or  sequence  number  (SEQ)  was  specified 
incorrectly,  change  the  parameter  specification,  then  resubmit  the  change  request. 


SYSOUT  DOES  NOT  RESIDE  ON  DISK 

Reason:  The  BACKUP=OFF  parameter  was  specified  on  the  change  request  to 
reset  the  tape  backup  indicator.  When  the  tape  backup  indicator  is  reset,  the 
SYSOUT  group  will  be  re-ardiived  to  tape  during  the  next  backup  cycle.  The 
backup  cycle  requires  that  the  SYSOUT  group  reside  on  disk,  but  the  SYSOUT 
group  specified  on  the  chan^  request  does  not  currently  reside  on  disk. 

Action:  If  the  change  request  is  being  requested  against  the  correct  SYSOUT 
group,  the  SYSOUT  group  can  be  reloaded  to  disk  via  the  LOAD  request  of  the 
SARBCH  utility. 

SYSOUT  IS  NOT  MARKED  FOR  DELETION 

Reason:  The  DELETE=OFF  parameter  was  specified  on  the  CHANGE  request  to 
reset  the  delete  indicator  for  the  SYSOUT  group,  but  the  SYSOUT  group  is  not 
currently  in  a  delete  status. 

Action:  Verify  that  the  correct  SYSOUT  group  is  being  referenced  on  the  change 
request.  If  additional  parameters  are  being  changed,  remove  the  DELETE=OFF 
parameter,  then  resubmit  the  change  request. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 

Action:  Consult  with  your  security  administrator  or  system  programming  group 
to  determine  the  reason  why  the  authorization  was  not  provided. 
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SYSOUT  GROUP  SUCCESSFULLY  DELETED 

Reason:  The  disk  space,, if  any,  occupied  by  the  requested  SYSOUT  group  and 
the  respective  master  index  references  have  been  successfully  deleted  from  the 
database. 

Action:  None. 

DISK  MEDIA  FOR  SYSOUT  GROUP  SUCCESSFULLY  DELETED 

Reason:  The  disk  space  occupied  by  the  requested  SYSOUT  group  has  been 
successfully  deleted  from  the  database.  The  SYSOUT  group  will  now  reside  in 
non-disk  status. 

Action:  None. 

VIEW  SUCCESSFULLY  DELETED 

Reason:  The  requested  view  was  successfully  deleted  from  the  master  index. 
Action:  None. 

USER  SUCCESSFULLY  DELETED 

Reason:  The  requested  user  ID  and  all  associated  online  variables  were 
successfully  deleted  from  the  master  index. 

Action:  None. 

INDEX  FILE  FOR  SYSOUT  GROUP  SUCCESSFULLY  DELETED 

Reason:  The  disk  space  occupied  by  the  report  index  for  the  requested  SYSOUT 
group  has  been  successfully  deleted  from  the  database. 

Action:  None. 

REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  delete  process,  or  the  manual  deletion 
of  the  SYSOUT  group  by  using  the  online  retrieval  facility  or  batch  retrieval 
facility  (SARBCH). 
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Note:  A  generic  SYSOUT  identifier  cannot  be  specified  in  the  delete  request. 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN)>  and/ or  sequence  number  (SEQ)  was  specified  incorrectly, 
change  the  respective  parameters,  then  resubmit  the  delete  request. 


ID  MISSING 

Reason:  The  ID  parameter  was  incorrectly  specified  without  a  SYSOUT 
identifier. 


Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
deleted,  then  resubmit  the  delete  request. 


DISK  MEDIA  NOT  DELETED  BECAUSE  SYSOUT  GROUP  IS 
CURRENTLY  OPEN 

Reason:  The  disk  space  for  the  requested  SYSOUT  group  was  not  deleted 
because  the  SYSOUT  group  is  currently  in  open  status.  The  SYSOUT  group  can 
be  in  open  status  due  to  a  currently  pending  temporary  load  operation,  a  pending 
migration  operation,  or  initial  creation. 


Action:  Wait  xmtil  the  status  of  the  SYSOUT  group  has  changed  from  open 
status,  then  resubmit  the  delete  request.  If  the  open  condition  is  invalid  (for 
example,  a  system  crashior  abend  occurred  while  the  SYSOUT  group  was  in  open 
status  and  being  processed)  use  the  CLEAN  operator  command  to  remove  the 
open  status.  Two  backup  cycles  and  a  duration  of  4  hours  must  have  elapsed 
before  the  open  status  is  removed. 


DISK  MEDIA  NOT  DELETED  BECAUSE  SYSOUT  GROUP  HAS  NO 
BACKUP 

Reason:  The  disk  space  for  the  requested  SYSOUT  group  was  not  deleted 
because  the  SYSOUT  group  has  no  tape  or  optical  archival  copy.  If  the  delete 
request  was  honored,  the  SYSOUT  group  would  not  have  any  archival  copy  and 
would  therefore  render  it  useless. 

Action:  Wait  until  the  completion  of  the  backup  cycle,  or  the  next  run  of  the 
optical  migration  subtask,  then  resubmit  the  delete  request. 
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DISK  MEDIA  NOT  DELETED  BECAUSE  SYSOUT  GROUP  DOES  NOT 
RESIDE  ON  DISK 

Reason:  The  SYSOUT  group  does  noti  reside  on  disk.  This  is  normally  caused  by 
a  backup  cycle  deleting  the  disk  space  for  the  SYSOUT  group  prior  to  completion 
of  the  delete  request,  or  die  disk  space  was  deleted  by  another  user  or  job  by 
using  the  online  retrieval  facility  or  batch  retrieval  facility  (SARBCH).  See  the 
initialization  parameter  NGEND  for  more  information. 


Action:  None;  since  the  SYSOUT  group  no  longer  resides  on  disk,  the  original 
intent  of  the  delete  disk  request  has  been  satisfied. 


DISK  MEDIA  NOT  DELETED  BECAUSE  SECONDARY  STORAGE 
DRIVER  WAS  NOT  AVAILABLE 

Reason:  The  SYSOUT  group  could  not  be  deleted  because  it  resided  on 
secondary  disk  storage,  and  no  secondary  disk  storage  driver  was  available. 

Action:  Rim  SARINTT  to  redefine  the  secondary  disk  storage  driver. 


VIEW  MISSING 

Reason:  The  VIEW  parameter  was  incorrectly  specified  without  a  view  number. 

Action:  Change  the  VIEW  parameter  to  include  the  view  niunber  that  is  to  be 
deleted  or  *  to  delete  all  views,  then  resubmit  the  delete  request. 


VIEW  KEYWORD  CONFLICTS  WITH  DISK/GEN/SEQ/INDEX 
KEYWORD(S) 

Reason:  The  VIEW  parameter  cannot  be  specified  with  the  DISK,  GEN,  SEQ> 
and/or  INDEX  parameters. 

Action:  Either  remove  the  VIEW  parameter  or  remove  the  DISK,  GEN,  SEQ, 
and/ or  INDEX  parameters  from  the  control  statement,  then  resubmit  the  delete 
request. 


REQUESTED  VIEW  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  view  does  not  exist  in  the  master  index.  This  is  normally 
caused  by  an  incorrect  specification  of  the  ID  parameter  and/or  the  VIEW 
parameter,  or  the  view  was  already  deleted  by  another  user  or  job  by  using  the 
online  retrieval  facility  or  batch  retrieval  facility  (SARBCH). 
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Action:  Verify  the  existence  of  the  view.  If  the  view  (VIEW  parameter)  or 
SYSOUT  identifier  (ID  parameter)  was  specified  incorrectly,  change  the 
parameter  specification,  then  resubmit  the  delete  request. 


USER  MISSING 

Reason:  The  USER  parameter  was  incorrectly  specified  without  a  user  ID; 

Action:  Change  the  USER  parameter  to  include  the  user  ID  that  is  to  be  deleted, 
then  resubmit  the  delete  request. 


USER  KEYWORD  CONFLICTS  WITH  DISK/GEN/ID/SEQ/INDEX 
KEYWORD(S) 

Reason:  The  USER  parameter  carmotbe  specified  with  the  DISK,  GEN,  ID,  SEQ, 
and/or  INDEX  parameters. 

Action:  Either  remove  the  USER  parameter  or  remove  the  DISK,  GEN,  ID,  SEQ, 
and/or  INDEX  parameters  fi'om  tihe  control  statement,  then  resubmit  the  delete 
request. 


REQUESTED  USER  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  user  ID  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  an  incorrect  specification  of  the  USER  parameter,  or  the  user 
ID  was  already  deleted  by  another  job  or  user  by  using  the  online  retrieval  facility 
or  batch  retrieval  facility  (SARBCH). 

Note:  A  generic  user  ID  cannot  be  specified  in  the  delete  request. 

Action:  Verify  the  existence  of  the  user  ID;  If  the  user  ID  (USER)  parameter  was 
specified  incorrectly,  change  the  parameter,  then  resubmit  the  job. 


USER  NOT  AUTHORIZED  TO  DELETE  USERID 

Reason:  The  user  ID  extracted  by  the  SARUSBUX  does  not  have  sufficient 
authority  (master  authority)  to  delete  user  IDs  from  the  database.  The  user  ID 
that  requires  authority  is  indicated  in  a  previous  (SARBGH05)  message. 

Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reason  why  the  authorization  was  not  provided. 
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USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 


Action:  Consult  with  your  security  administrator  or  system  programming  group 
to  determine  the  reason  why  the  authorization  was  not  provided. 


ID  MISSING 

Reason:  The  ID  parameter  was  specified  without  a  SYSOUT  identifier  which  is 
required  on  the  control  statement. 

Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
printed,  then  resubmit  the  print  request. 


REPORT  SUCCESSFULLY  PRINTED 

Reason:  The  CA-Deliver  report  was  successfully  queued  to  print. 
Action:  None. 


SYSOUT  QUEUED  FOR  TRANSMIHAL  TO  PC 

Reason:  The  CA-Deliver  report  was  successfully  queued  for  download  to  a  PC. 
The  download  process  can  be  completed  at  the  user's  discretion  from  the  online 
retrieval  interface. 

Action:  None. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  print  process  or  the  manual  deletion  of 
the  SYSOUT  group  by  using  the  online  retrieval  facility  or  batch  retrieval  facility 
(SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN),  and/or  sequence  n\imber  (SEQ)  was  specified  incorrectly, 
change  the  parameter  specification,  then  resubmit  the  print  request. 
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SYSOUT  GROUP  WAS  NOT  ARCHIVED  BY  DELIVER 

Reason:  The  print  request  referenced  a  SYSOUT  group  that  was  not  archived  by 
CA-Deliver. 


Action:  Either  change  the  SYSOUT  identifier  (ID  parameter)  to  specify  a 
CA-Deliver  report,  or  print  the  report  with  the  /PRINT  control  statement. 


REPORT  IDENTIFIER  xxxxxxxxxxxx  NOT  FOUND  IN  DATABASE 

Reason:  The  requested  report  does  not  exist  in  the  master  index.  This  is  normally 
caused  by  a  backup  cycle  deleting  the  report  prior  to  completion  of  the  print 
process,  or  the  manual  deletion  of  the  report  by  using  the  online  retrieval  facility 
or  batch  retrieval  facility  (SARBCH). 

Action:  Verify  the  existence  of  the  report.  If  the  report  identifier  (ID),  generation 
(GEN),  and/or  sequence  number  (SEQ)  was  specified  incorrectly,  change  the 
respective  parameter,  then  resubmit  the  print  request. 


I/O  error  message 

Reason:  I/O  operation  against  the  GA-Deliver  database  failed.  The  error 
message  can  range  from  a  severe  error  condition  such  as  physical  or  logical  I/O 
error,  to  non-severe  error  condition  such  as  record  not  found  or  database  not 
defined. 

Action:  If  a  database  not  foimd  message  is  produced,  verify  that  the  EXPRESS 
initialization  parameter  references  the  correct  database.  Also  verify  that  there  is  a 
STEPLIB  statement  for  the  CA-Deliver  load  modules  in: 

■  The  CA-View  skeleton  JCL 

■  The  JCL  for  any  of  the  online  interfaces  (these  are  both  part  of  installing 
CA-View) 

If  a  record  not  found  message  is  produced,  the  respective  identifier  may  have  to 
be  removed  from  the  print  request.  See  your  CA-Deliver  documentation  to 
remedy  severe  error  conditions. 


INVALID  USE  OF  PARENTHESIS  IN  DIST  PARAMETER 

Reason:  The  syntax  of  the  DIST  parameter  is  invalid.  This  is  normally  caused  by 
unbalanced  parentheses  or  excessive  parentheses. 

Action:  Review  the  syntax  of  the  DIST  parameter  on  the  /EPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  reprint  request. 
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INVALID  DISTRIBUTION  IDENTIFIER  IN  DIST  PARAMETER 

Reason:  The  distribution  identifier  in  the  DIST  parameter  contains  invalid 
characters  or  too  many  characters.  The  distribution  identifier  can  be  from  1  to  8 
characters  in  length  and  consists  of  alphanumeric,  and  national  ($,  @,  or  #) 
characters. 

Action:  Review  the  syntax  of  the  DIST  parameter  on  the  /EPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  print  request. 


INVALID  DESTINATION  IN  DIST  PARAMETER 

Reason:  The  destination  field  in  the  DIST  parameter  contains  invalid  characters 
or  too  many  characters.  The  destination  field  can  be  from  1  to  17  characters  in 
length  and  consists  of  two  qualifiers  that  are  alphanumeric,  and  national  ($,  @,  or 
#)  characters. 

Action:  Review  the  syntax  of  the  DIST  parameter  on  the  /EPRINT  control 
statement,  correct  the  parameter  specification,  then  resubmit  the  print  request. 


INVALID  TEXT  STRING  IN  INST  PARAMETER 

Reason:  The  S5mtax  of  the  INST  parameter  is  invalid.  This  can  be  caused  by 
unbalanced  quotes,  excessive  quotes  (quotes  within  nonrquoted  string),  invalid 
separator  (blank,  comma,  or  parenthesis  not  following  quoted  string),  or  too 
many  characters  in  text  string  (maximum  of  74  characters). 

Action:  Review  the  syntax  of  the  INST  parameter  on  the  /EPRINT  control 
statement,  correct  the  paarameter  specification,  then  resubmit  the  print  request. 


NO  DISTRIBUTION  IDENTIFIERS  FOR  REPORT  -  USE  VIEW  TO 
PRINT  REPORT 

Reason:  You  have  tried  to  print  a  CA-Deliver  report  without  specifying  any 
DIST  IDs  which  are  gettmg  the  report. 

Action:  Either  specify  at  least  one  receiving  DIST  ID,  or  switch  to  SAR  MODE 
and  retry  the  print  request.  You  can  switch  to  SAR  MODE  by  either  typing  SAR 
in  the  command  area  and  pressing  ENTER,  or  by  typing  MODE  SAR  in  the 
command  line  of  the  primary  menu  and  pressing  ENTER, 
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REPORT  SUCCESSFULLY  PRINTED,  DISTsXXXXXXXX  AT  xxxxxxxx 


Reason;  The  report  was  printed  for  the  DIST  ID  indicated  on  the  printer 


Action:  None. 


ERRORS  ON  OTHER  DESTINATIONS  PREVENTED  PRINTING, 
DIST=xxxxxxxx  AT  xxxxxxxx 

Reason:  The  report  could  not  be  printed  for  the  DIST  ID  indicated  on  the  printer 
specified  because  of  another  error  in  the  print  request. 

Action:  Correct  the  error  as  indicated  in  the  associated  error  message  and  try  the 
print  request  again. 


message  text  varies,  DIST=xxxxxxxx  AT  xxxxxxxx 

Reason;  A  subprogram  returned  a  message  which  is  being  repeated  here.  The 
print  request  was  to  print  the  DISTID 'indicated  on  the  printer  specified. 

Action:  Varies  depending  on  the  message  text  displayed. 


SELECT  SPECIFICATION  CONFLICTS  WITH  PAGE  AND/OR 
RECORD  SPECIFICATION 

Reason;  The  SELECT  keyword  and  the  PACE  and/or  RECORD  keywords  are 
mutually  exclusive. 

Action;  Either  remove  the  SELECT  parameter  or  remove  the  PAGE  and/or 
RECORD  parameters  from  the  control  statement,  then  resubmit  the  print  request. 


SYSOUT  IS  NOT  ON  PRIMARY  DISK  AND  ITS  INDEX  IS 
UNAVAILABLE  FOR  PAGE  SELECTION 

Reason;  The  SELECT  keyword  was  specified  but  the  SYSOUT  group  resides  on 
tape. 

Action;  Either  remove  the  SELECT  keyword  to  print  the  entire  SYSOUT  group, 
or  temporarily  reload  the  SYSOUT  group  to  the  database  so  that  its  index  will  be 
available  for  printing. 
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SELECT  SPECIFIED  WITHOUT  A  VALID  LOGICAL  VIEW 

Reason:  The  SELEO  keyword  was  specified  and  either  the  CA-View  ke3rword 
was  omitted  or  specified  for  an  invalid  logical  view. 

Action:  Correct  the  parameter  specification,  then  resubmit  the  print  request. 


ERROR  OCCURRED  AHEMPTING  TO  READ  IN  THE  INDEX  FOR  THE 
SYSOUT 

Reason:  An  error  occurred  attempting  to  obtain  the  index  for  the  SYSOUT 
group. 

Action:  Either  remove  the  SELECT  keyword  to  print  the  entire  SYSOUT  group 
or  re-archive  the  SYSOUT  group  to  create  a  new  index. 


SYSOUT  HAS  NOT  BEEN  INDEXED  FOR  THE  LOGICAL  VIEW  OR  BY 
ACIF 

Reason:  The  page  separation  definition  in  the  logical  view  either  did  not  exist 
when  the  SYSOUT  group  was  archived  or  was  changed  subsequently. 

Action:  Either  remove  ttie  SELECT  keyword  to  print  the  entire  SYSOUT  group, 
re-index  the  SYSOUT  group,  or  re-archive  the  SYSOUT  group  to  create  a  new 
index. 


NO  PAGES  FOUND  THAT  MATCH  SELECTION  TEXT 

Reason:  The  selection  text  does  not  exist  in  the  index  for  the  logical  view  of  the 
SYSOUT  group.  This  is  normally  caused  by  an  incorrect  spelling  on  the  SELECT 
keyword  or  the  page  separation  criteria  was  never  defined  for  the  SYSOUT 
group. 

Action:  Either  change  the  SELECT  parameter  to  reference  a  different  index 
specification  or  remove  the  SELECT  keyword  to  print  the  entire  SYSOUT  group. 


USER  IS  NOT  AUTHORIZED  TO  PRINT  REPORT  FROM  THIS 
DESTINATION 

Reason:  The  SARDSTUX  user  exit  did  not  allow  the  report  to  be  printed  to  its 
respective  destination. 

Action:  Consult  with  your  security  administrator  or  system  programming  group 
to  determine  the  reason  why  the  authorization  was  not  provided. 
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REQUESTED  INDEX  NOT  FOUND 

Reason:  The  page  index  value  specified  on  the  SELECT  keyword  of  the  print 
request  was  not  foxmd  for  the  requested  SYSOUT  group. 

Action:  Verify  that  the  correctpage  index  value,  SYSOUT  group,  and  view  are 
being  specified.  Otherwise,  remove  the  SELECT  parameter  and  print  the  entire 
SYSOUT  group. 


NO  TOR  RECORD  FOUND  FOR  REQUESTED  SYSOUT 

Reason:  An  attempt  is  being  made  to  print  a  SYSOUT  group  from  tape,  but 
certain  vital  backup  tape  control  information  could  not  be  found. 

Action:  Normally,  tape  control  information  is  retained  as  long  as  there  are 
reports  that  reference  it.  The  tape  control  record  (TCR)  can  be  reinstated  by  re¬ 
adding  the  tape  back  into  the  database  with  the  TADD  facility  of  the  SARTDR 
utility. 

Important!  This  condition  could  identify  a  serious  problem  with  the  database  or 
problems  with  the  supporting  code.  Report  the  problem  to  Computer  Associates  Technical 
Support. 


ERROR  DURING  SECONDARY  DISK  OR  EAS  ACCESS 

Reason:  An  error  occurred  opening  a  report  on  optical  disk,  or  on  tape  accessed 
through  an  EAS  tape  server. 

Action:  Browse  the  report  online  to  see  any  error  messages  from  the  DSIC2  driver 
or  EAS  tape  server  interface  routine. 


JOB/USER  NOT  AUTHORIZED  TO  ACCESS  DATABASE 

Reason:  The  SARATHUX  security  user  exit  did  not  allow  the  job  or  user  access 
to  the  database. 

Action:  Consult  with  your  security  administrator  or  system  programming  group 
to  determine  the  reason  why  the  authorization  was  not  provided. 


INVALID  OR  MISPLACED  CONTROL  CARD,  CONTROL  STATEMENT 
MUST  BEGIN  WITH  A  / 

Reason:  A  slash  (/),  denoting  a  new  control  statement,  was  expected  in  colximn  1 
of  the  control  card  but  was  not  foimd. 
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Action:  Review  syntax  of  control  statement,  insert  a  slash(/)  before  the  function 
name  in  column  1  of  the  control  card,  then  resubmit  the  job. 


INVALID  FUNCTION  NAME 

Reason:  The  specified  function  name  (name  that  follows  the  slash)  contains 
invalid  characters,  contains  too  many  characters,  or  is  not  a  valid  batch  retrieval 
functioni 

Note:  The  fimction  name  must  immediately  follow  a  slash  (/)  which  is  coded  in 
column  1  of  the  control  card.  Also,  control  statements  that  continue  onto  multiple 
control  cards  are  not  prefixed  with  the  slash. 

Action:  Review  the  spelling  of  function  name  and  the  S5mtax  of  the  control 
statement,  correct  the  control  statement  specification,  then  resubnut  the  job. 


LOGON  SUCCESSFUL  FOR  useridlO  database 

Reason:  The  user  ID  determination  exit  (SARUSBUX)  provided  successful  logon 
for  the  specified  user  ID  to  the  specified  database. 

Action:  None.  User  ID  logon  is  performed  during  initial  access  to  the  database. 


LOGON  UNSUCCESSFUL  FOR  userid  lO  database 

Reason:  The  user  ID  determination  exit  (SARUSBUX)  did  not  allow  logon  for  the 
specified  user  ID  to  the  specified  database. 

Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reason  why  the  authorization  was  not  provided. 


INVALID  KEYWORD  NAME  xxxxxxxx 

Reason:  The  specified  keyword  name  contains  invalid  characters,  contains  too 
many  characters,  or  is  not  a  valid  name. 

Action:  Review  syntax  of  control  statement  and  spelling  of  the  keyword  name, 
correct  the  parameter  specification,  then  resubmit  the  job. 


INVALID  PARAMETER  DATA  FOR  KEYWORD 

Reason:  The  parameter  data  for  the  specified  keyword  contains  invalid 
characters  or  is  not  an  acceptable  value. 
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Action:  Review  syntax  of  control  statement)  correct  the  parameter  specification, 
then  resubmit  the  job: 


UNBALANCED  QUOTED  STRING  ENCOUNTERED  IN  PARAMETER 
DATA  FOR  KEYWORD 

Reason:  The  parameter  data  for  the  specified  keyword  contains  a  quoted  string 
that  was  not  terminated  by  an  ending  quote. 

Action:  Review  syntax  of  control  statement,  correct  the  parameter  specification, 
then  resubmit  the  job. 


UNBALANCED  PARENTHESES  ENCOUNTERED  IN  PARAMETER 
DATA  FOR  KEYWORD 

Reason:  The  parameter  data  for  the  specified  keyword  contains  an  incorrect 
number  of  parentheses.  For  every  right  parenthesis  there  must  be  a  matching  left 
parenthesis. 

Action:  Review  syntax  of  control  statement,  correct  the  parameter  specification, 
then  resubmit  the  job. 


PARAMETER  DATA  TOO  LONG  FOR  KEYWORD 

Reason:  The  parameter  data  for  the  specified  keyword  contains  too  many 
characters. 

Action:  Review  syntax  of  conbrol  statement)  correct  the  parameter  specification, 
then  resubmit  the  job. 


TOO  MANY  PARAMETERS  SPECIFIED  FOR  KEYWORD 

Reason:  The  parameter  data  for  the  specified  keyword  contains  too  many  values. 

Action:  Review  syntax  of  control  statement,  correct  the  parameter  specification, 
then  resubmit  the  job. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  at  the  same  release 
level.  This  is  normally  caused  by  the  STEPLIB)  JOBLIB,  link-list,  or  LPA  pointing 
to  old  load  modules,  or  the  database  has  not  been  converted  to  the  correct  release 
level  (new  releases  of  product  may  require  conversion  of  the  database). 


12-64  CA- View  System  Reference  Guide 


Diagnostic  and  Error  Messages 


SARBCI01 


SARBCI02 


SARBCI03 


SARBCK02 


SARBCK03 


Action:  Either  STEPLIB  to  the  correct  load  modules  or  convert  the  database  to 
the  correct  release  level. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 


Reason:  The  SARSEGUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 


Action:  Consult  with  your  security  administrator  or  system*  programming  group 
to  determine  the  reason  why  the  audiorization  was  not  provided. 


ID  MISSING 

Reason:  The  ID  parameter  was  incorrectly  specified  without  a  SYSOUT 
identifier. 

Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
re-indexed,  then  resubmit  the  index  request. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  index  process,  or  the  manual  deletion 
of  the  SYSOUT  group  using  the  online  retrieval  facility  or  batch  retrieval  facility 
(SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN),  and/or  sequence  number  (SEQ)  was  specified  incorrectly, 
change  the  parameter  specification,  then  resubmit  the  index  request. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 


Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reason  why  the  authorization  was  not  provided. 


ID  MISSING 


Reason:  The  ID  parameter  was  incorrectly  specified  without  a  SYSOUT  identifier 
and  is  required  on  the  control  statement. 
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Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
set  to  or  removed  from  permanent  status,  then  resubmit  the  PERM  request. 


DISK/TAPE/DELETE  KEYWORDS  CONFLICT,  ONLY  ONE  OF  THESE 
KEYWORDS  MAY  BE  SPECIFIED 

Reason:  The  DISK,  TAPE,  and/ or  DELETE  keywords  are  mutually  exclusive 
and  cannot  be  specified  on  the  same  control  statement. 

Action:  Change  control  statement  to  specify  either  DISK,  TAPE,  or  DELETE, 
then  resubmit  PERM  request. 


SYSOUT  GROUP  SUCCESSFULLY  SET  TO  PERMANENT  DISK  STATUS 

Reason:  The  SYSOUT  group  was  successfully  set  to  a  permanent  on  disk  status 
(location  of  PERM).  The  long  term  status  of  the  SYSOUT  group  will  depend  on 
the  setting  of  the  Expanded  Retention  Option  irutialization  parameters  and  table 
parameters. 

Action:  None. 


SYSOUT  GROUP  SUCCESSFULLY  SET  TO  PERMANENT  TAPE  STATUS 

Reason:  The  SYSOUT  group  was  successfully  set  to  permanent  on  tape  status 
(location  of  PDSK,  PTMP,  or  PTAP).  The  long  term  status  of  the  SYSOUT  group 
will  depend  on  the  setting  of  the  Expanded  Retention  Option  initialization 
parameters  and  table  parameters. 

Action:  None. 


SYSOUT  GROUP  SUCCESSFULLY  REMOVED  FROM  PERMANENT 
STATUS 

Reason:  The  SYSOUT  group  was  successfully  removed  from  permanent  status. 
The  disk  and  tape  retention  of  the  SYSOUT  group  depends  on  the  setting  of  the 
NGEND  and  NGENT  initialization  parameters. 

Action:  None. 
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SYSOUT  GROUP  IS  ON  SECONDARY  DISK  STORAGE  - 
PERMANENT  STATUS  NOT  DELETED 

Reason;  The  SYSOUT  group  resides  on  secondary  disk  storage  and  must  remain 
in  permanent  status. 

Action:  None.  Permanent  status  cannot  be  deleted. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  PERM  process,  or  the  manual  deletion 
of  the  SYSOUT  group  by  using  the  online  retrieval  facility  or  batch  retrieval 
facility  (SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN),  and/ or  sequence  number  (SEQ)  was  specified  incorrectly, 
change  the  parameter  specifications,  then  resubmit  the  PERM  request. 


PERMANENT  STATUS  NOT  SET  BECAUSE  SYSOUT  GROUP  IS 
CURRENTLY  OPEN 

Reason;  The  SYSOUT  group  was  not  set  to  or  removed  from  permanent  status 
because  the  SYSOUT  group  is  currently  in  open  status.  The  SYSOUT  group  can 
be  in  open  status  due  to  a  currently  pending  temporary  load  operation,  a  pending 
migration  operation,  or  initial  creation. 

Action:  Wait  until  the  status  of  the  SYSOUT  group  has  changed  from  open 
status,  then  resubmit  PERM  request.  If  the  open  condition  is  invalid,  (for 
example,  a  system  crash  or  an  abend  occurred  while  the  SYSOUT  group  was  in 
open  status  and  being  processed),  use  the  CLEAN  operator  command  to  remove 
the  open  status.  Two  backup  cycles  and  a  duration  of  4  hours  must  have  elapsed 
before  the  open  status  is  removed. 


PERMANENT  DISK  STATUS  NOT  SET  BECAUSE  SYSOUT  GROUP  IS 
NOT  ON  DISK 

Reason:  The  SYSOUT  group  cannot  be  set  to  a  permanent  on  disk  status  because 
the  SYSOUT  group  does  not  reside  on  disk  media. 

Action:  Temporarily  load  SYSOUT  group  to  the  database,  then  resubmit  PERM 
request. 
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USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT  O 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 


Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reason  why  the  authorization  was  not  provided. 


ID  MISSING 

Reason:  The  ID  parameter  was  incorrectly  specified  without  a  SYSOUT  identifier 
and  is  required  on  the  control  statement. 

Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
loaded,  then  resubmit  the  load  request. 


DDNAME  xxxxxxxx  NOT  FOUND 

Reason:  The  JCL  DD  statement  name  specified  in  the  DDNAME  parameter  was 
not  provided. 

Action:  Either  remove  the  DDNAME  parameter  or  specify  the  respective  JCL 
DD  statement,  then  resubmit  the  load  request. 


SYSOUT  SUCCESSFULLY  LOADED 

Reason:  The  SYSOUT  group  was  successfully  loaded  from  tape  to  the  database 
and  resides  in  a  temporary  on  disk  status. 

Action:  None. 

SYSOUT  SUCCESSFULLY  WRIHEN  TO  DDNAME= 

Reason:  The  SYSOUT  group  was  successfully  copied  to  the  specified  JCL  DD 
statement. 


Action:  None. 


INDEX  FILE  SUCCESSFULLY  LOADED 

Reason:  The  page  index  file  for  the  requested  SYSOUT  group  was  successfully 
loaded  from  tape  or  secondary  disk  to  the  CA-View  database. 
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Action:  None. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  load  process,  or  the  manual  deletion  of 
the  SYSOUT  group  by  using  the  online  retrieval  facility  or  batch  retrieval  facility 
(SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN),  and/or  sequence  number  (SEQ)  was  specified  incorrectly, 
change  the  parameter  specification,  then  resubmit  the  load  request. 


DATASET  NOT  LOADED  -  ALREADY  ON  DISK 


Reason:  The  SYSOUT  group  was  not  loaded  to  the  database  because  it  already 
resides  on  disk. 

Action:  Since  the  original  intent  of  the  load  request  has  been  satisfied,  no  further 
action  is  necessary.  If  the  SYSOUT  group  was  incorrectly  loaded  or  is  empty,  the 
disk  portion  of  the  SYSOUT  group  can  be  deleted  by  using  the  online  retrieval 
facility  or  batch  retrieval  facility,  and  the  load  request  can  be  resubmitted. 


REQUESTED  SYSOUT  DOES  NOT  EXIST  ON  ANY  TAPE  BACKUP 
DATASET 

Reason:  The  SYSOUT  group  could  not  be  foimd  on  any  tape  backup. 
Action:  None.  The  SYSOUT  group  is  not  available  on  tape. 

THE  TAPE  FILE  WAS  NOT  THE  SELECTED  SYSOUT  GROUP  -  USE 
SARTCP  TO  MAP  THE  TAPE 


Reason:  The  SYSOUT  group  located  on  the  backup  tape  is  not  the  same  as 
referenced  in  the  master  index. 

Action:  Use  the  SARTCP  utility  to  map  and  correct  the  backup  tape. 
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BACKUP  TAPE  DOES  NOT  EXIST 

Reason:  The  backup  tape  could  not  be  found  in  the  master  index.  This  is 
normally  caused  by  the  backup  cycle  deleting  the  tape  prior  to  completion  of  the 
load  request. 

Action:  None.  The  SYSOUT  group  is  no  longer  available. 


DYNAMIC  ALLOCATION  FAILED  FOR  TAPE  FILE,  ERROR 
CODE  -  xxxx,  INFO  CODE  -  xxxxx 

Reason:  Dynamic  allocation  failed  for  allocating  the  backup  tape  file.  The 
hexadecimal  error  and  information  codes  are  provided: 

Action:  Consult  the  online  retrieval  HELP  facility  for  a  description  of  the 
dynamic  allocation  error  code.  Take  appropriate  action  to  correct  the  allbcation 
error,  then  resubmit  the  load  request. 


I/O  ERROR  POSITIONir\K5  TAPE 

Reason:  A  permanent  I/O  error  occurred  attempting  to  position  the  archival 
tape  to  retrieve  the  SYSOUT  group. 

Action:  Resubmit  the  request.  If  the  I/O  error  occurs  again,  use  the  SARTCP 
utility  to  map  and  correct  the  tape. 


SYSOUT  GROUP  IS  OPEN  FOR  OUTPUT 

Reason:  The  requested  function  could  not  be  performed  because  the  specified 
SYSOUT  group  is  open  for  output.  The  SYSOUT  group  can  be  in  open  status  due 
to  a  currently  pending  temporary  load  operation,  a  pending  migration  operation, 
or  initial  creation. 

Action:  Waitimtil  the  status  of  the  SYSOUT  group  has  changed  from  open 
status,  then  resubmit  load  request.  If  the  open  condition  is  invalid,  that  is,  a 
system  crash  or  an  abend  occurred  while  the  SYSOUT  group  was  in  open  status 
and  being  processed,  use  the  CLEAN  operator  command  to  remove  the  open 
status.  Two  backup  cycles  and  a  duration  of  4  hours  must  have  elapsed  before  the 
open  status  is  removed. 


PERMANENT  I/O  ERROR  ON  INPUT  TAPE 

Reason:  A  permanent  1/ O  error  occurred  attempting  to  read  SYSOUT  data  from 
a  backup  tape. 
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Action:  Resubmitthe  load  request.  If  the  I/O  error  occurs  again,  use  the 
SARTCP  utility  to  map  and  correct  the  tape.  Also  see  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  recovery  procedures. 


VIEW  NOT  FOUND 

Reason:  The  specified  view  does  not  exist  in  the  master  index. 

Action:  Verify  the  existence  of  the  view.  If  the  view  nmnber  was  specified 
incorrectly,  change  the  parameter  specification,  then  resubmit  the  load  request. 


INDEX  FILE  ALREADY  RESIDES  ON  DISK 


Reason:  A  load  request  was  issued  to  specifically  load  the  page  index  file  for  the 
requested  SYSOUT  group  from  tape  or  secondary  disk  to  the  CA-View  database, 
but  the  page  index  file  already  resides  on  the  dick 

Action:  Since  the  page  index  file  already  resides  on  disk,  the  load  request  is  not 
necessary.  If  there  is  something  wrong  with  the  page  index  file  on  the  CA-View 
database,  the  page  index  file  can  be  deleted  and  then  reloaded. 


INDEX  FILE  WAS  NOT  FOUND  ON  TAPE  OR  SECONDARY  DISK 

Reason:  A  load  request  was  issued  to  specifically  load  the  page  index  file  for  the 
requested  SYSOUT  group  from  tape  or  secondary  disk  to  the  CA-View  database, 
but  no  page  index  file  was  generated  for  the  SYSOUT  group. 

Action:  Re-index  or  re-archive  the  report  to  generate  a  page  index  file  for  the 
SYSOUT  group. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  specified  ' 
SYSOUT  group. 

Action:  Consult  with  your  security  administrator  or  system  programming  group 
to  determine  the  reason  why  the  authorization  was  not  provided. 


ID  MISSING 

Reason:  The  ID  parameter  was  incorrectly  specified  without  a  SYSOUT  identifier 
and  is  requited  on  the  control  statement. 
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Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
printed,  then  resubmit  Ihe  print  request 

DDNAME  xxxxxxxx  NOT  FOUND 

Reason:  The  JCL  DD  statement  name  specified  in  the  DDNAME  parameter  was 
not  provided. 

Action:  Either  remove  the  DDNAME  parameter  or  specify  the  respective 
DDNAME. 


SYSOUT  SUCCESSFULLY  PRINTED 

Reason;  The  SYSOUT  group  was  successfully  queued  to  print 
Action:  None. 

SYSOUT  SUCCESSFULLY  WRIHEN  TO  DDUAME=xxxxxxxx 

Reason:  The  SYSOUT  group  was  successfully  copied  to  the  specified  JCL  DD 
statement 

Action:  None. 

SYSOUT  QUEUED  FOR  TRANSMIHAL  TO  PC 

Reason;  The  CA-Deliver  report  was  successfully  queued  for  download  to  a  PC. 
The  download  process  will  be  complete  at  the  users  discretion  from  the  online 
retrieval  interface. 

Action:  None. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason;  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  the  completion  of  the  print  process,  or  the  manual 
deletion  of  the  SYSOUT  group  by  using  the  oidine  retrieval  facility  or  batch 
retrieval  facility  (SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN),  and/or  sequence  number  (SEQ)  was  specified  incorrectly, 
change  the  parameter  specification,  then  resubmit  the  print  request. 
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DATASET  NOT  LOADED  -  ALREADY  ON  DISK 

Reason:  The  SYSOUT  group  was  not  loaded  to  the  database  because  it  already 
resides  on  disk. 

Action:  Since  the  original  intent  of  the  load  request  has  been  satisfied,  no  further 
action  is  necessary.  If  the  SYSOUT  group  was  incorrectly  loaded  or  is  empty,  the 
disk  portion  the  SYSOUT  group  can  be  deleted  by  using  the  online  retrieval 
facility  or  batch  retrieval  facility,  and  the  load  request  can  be  resubmitted. 


REQUESTED  SYSOUT  DOES  NOT  EXIST  ON  ANY  TAPE  BACKUP 
DATA 

Reason:  The  SYSOUT  group  could  not  be  foimd  on  any  backup  tape. 
Action:  None.  The  SYSOUT  group  is  not  available  on  tape. 


THE  TAPE  FILE  WAS  NOT  THE  SELECTED  SYSOUT  GROUP  -  USE 
SARTCP  TO  MAP  THE  TAPE 

Reason:  The  SYSOUT  group  located  on  the  backup  tape  is  not  the  SYSOUT  as 
referenced  in  the  master  index. 

Action:  Use  the  SARTCP  utility  to  map  and  correct  the  backup  tape. 


BACKUP  TAPE  DOES  NOT  EXIST 

Reason:  The  backup  tape  could  not  be  foimd  in  the  master  index.  This  is 
normally  caused  by  the  backup  cycle  deleting  the  tape  prior  to  completion  of  the 
load  request. 

Action:  None.  The  SYSOUT  group  is  no  longer  available. 


DYNAMIC  ALLOCATION  FAILED  FOR  TAPE  FILE,  ERROR  CODE  - 
xxxx  INFO  CODE  -  xxxxx 

Reason:  Dynamic  allocation  failed  for  allocating  the  backup  tape  file.  The 
hexadecimal  error  and  information  codes  are  provided. 

Action:  Consult  the  online  retrieval  HELP  facility  for  a  description  of  the 
d5mamic  allocation  error  code.  Take  appropriate  action  to  correct  the  allocation 
error,  then  resubmit  the  print  request. 
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I/O  ERROR  POSITIONING  TAPE 


Reason:  A  permanent  I/O  error  occurred  attempting  to  position  the  archival 
tape  to  retrieve  the  SYSOUT  group. 


Action:  Resubmit  the  request.  If  the  I/O  error  occurs  again,  use  the  SARTCP 
utility  to  map  and  correct  the  tape. 


SYSOUT  GROUP  IS  OPEN  FOR  OUTPUT 

Reason:  The  requested  function  could  not  be  performed  because  the  specified 
SYSOUT  group  is  open  for  output.  The  SYSOOT  group  can  be  in  open  status  due 
to  a  currently-pending  temporary  load  operation,  a  pending  migration  operation, 
or  initial  creation. 

Action:  Wait  until  the  status  of  the  SYSOUT  group  has  changed  from  open 
status,  then  resubmit  print  request.  If  the  open  condition  is  invalid,  that  is,  a 
system  crash  or  abend  occurred  while  the  SYSOUT  group  was  in  open  status  and 
being  processed,  use  the  CLEAN  operator  command  to  remove  the  open  status. 
Two  backup  cycles  and  a  duration  of  4  hours  must  have  elapsed  before  the  open 
status  is  removed. 


PERMANENT  I/O  ERROR  ON  INPUT  TAPE 

Reason:  A  permanent  I/O  error  occurred  attempting  to  read  SYSOUT  data  from 
a  backup  tape. 

Action:  Resubmit  the  request.  If  the  I/O  error  occurs  again,  use  the  SARTCP 
utility  to  map  and  correct  the  tape.  Also  see  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  recovery  procedures. 


VIEW  NOT  FOUND 

Reason:  The  specified  view  does  not  exist  in  the  master  index. 

Action:  Verify  the  existence  of  the  view.  If  the  view  number  was  specified 
incorrectly,  change  the  parameter  specification,  then  resubmit  the  print  request. 


DYNAMIC  ALLOCATION  FAILED  FOR  SYSOUT  FILE,  ERROR  CODE 
-  xxxx,  INFO  CODE  -  xxxxx 

Reason::  Dynamic  allocation  failed  for  allocating  the  print  SYSOUT  data  set.  The 
hexadecimal  error  and  inf ormation  codes  are  provided. 
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Action:  Consult  the  online  retrieval  HElLP  facility  for  a  description  of  the 
d5nnainic  allocation  error  code.  Take  appropriate  action  to  correct  the  allocation 
error,  then  resubmit  load  request. 


//  OUTPUT  FAILED  FOR  SYSOUT.  REASON  -  xxxxxxxx 

Reason:  An  error  occurred  attempting  to  create  an  OUTPUT  JCL  statement  for 
the  SYSOUT  group.  The  hexadecimal  reason  code  from  SJF  is  provided. 

Action:  Determine  the  cause  of  the  allocation  error.  A  possible  alternative  is  to 
remove  the  output  JCL  parameter,  for  example,  PAGEDEF,  FORMDEF, 
LEnJECNT,  and  PRMODE. 


PC  TRANSMIHAL  QUEUE  FULL  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  PC  transmittal  queue  is  full  for  the  user. 

Action:  Have  the  user  transmit  his  queue  and  clear  the  entries. 


PC  DESTINATION  INVALID  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  destination  specified  must  be  of  the  format  PC  user  ID: 
Action:  Correct  the  destination. 


USER  NOT  DEFINED  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  user  ID  specified  in  the  destination  is  not  defined  to  CA-View. 
Action:  Correct  the  destination  or  define  the  user  ID  to  CA-View. 


SYSOUT  QUEUED  FOR  EXTERNAL  PRINT 

Reason:  The  external  print  request  was  successfully  queued  for  processing. 
Action:  None. 

PRINTER  SPECIFICATION  CONFLICTS  WITH  DEST  AND/OR 
DDNAME  SPECIFICATION 

Reason:  The  SARBCH  print  request  has  failed  because  the  PRINTER  keyword  is 
mutually  exclusive  with  the  DEST  and/or  DDNAME  specifications. 
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Action:  Eliminate  either  the  DEST  or  DDNAME  keyword  specifications,  then 
resubmit  the  print  request. 


SELECT  SPECIFICATION  CONFLICTS  WITH  PAGE  AND/OR 
RECORD  SPECIFICATION 

Reason:  The  SARBCH  print  request  has  failed  because  the  SELECT  keyword  is 
mutually  exclusive  with  the  PAGE  and  RECORD  specifications. 


Action:  Eliminate  either  the  SELECT,  PAGE,  or  RECORD  keyword  specification, 
then  resubmit  the  print  request. 


SYSOUT  IS  NOT  ON  PRIMARY  DISK  AND  ITS  INDEX  IS 
UNAVAILABLE  FOR  PAGE  SELECTION 

Reason:  The  SARBCH  print  request  specifying  the  SELECT  keyword  has  failed 
because  the  SYSOLTT  does  not  reside  on  disk.  The  most  likely  reason  for  this  is 
that  the  location  is  TAPE. 

Action:  Reload  the  SYSOUT  to  disk.  Verify  that  the  index  is  present,  then 
resubmit  the  print  request. 


SELECT  SPECIFIED  WITHOUT  A  VALID  LOGICAL  VIEW 

Reason:  The  SARBCH  print  request  specifying  the  SELECT  keyword  has  failed 
because  no  views  exist  for  the  SYSOUT. 

Action:  Do  one  of  the  following: 

■  Remove  the  SELECT  keyword,  then  resubmit  the  print  request. 

■  Specify  a  view  number  that  contained  page  indexing  criteria  when  the 
SYSOUT  was  archived,  then  resubmit  the  request. 

Note:  Page  indexing  occurs  only  during  archival. 


ERROR  OCCURRED  AHEMPTING  TO  READ  IN  THE  INDEX  FOR  THE 
SYSOUT 

Reason:  The  SARBCH  print  request  specifying  the  SELECT  keyword  has  failed 
because  an  I/O  error  occurred  while  opening  or  reading  the  page  index  data 
from  the  database.  The  data  is  urueadable. 

Action:  Do  one  of  the  following: 

■  Remove  the  SELECT  keyword,  then  resubmit  the  print  request. 
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■  Rebuild  the  page  index  data  as  follows: 

1.  Reprint  the  SYSOUT  to  a  held  class. 

2.  Delete  the  SYSOUT  from  CA-View 

3.  Release  the  SYSOUT  to  CA-View  for  re-archival,  retaining  the  same 
SYSOUT-ID. 

4.  Resubmit  the  print  request. 

Note:  The  index  canibe  rebuilt  only  by  re-archiving  the  SYSOUT. 


SYSOUT  HAS  NOT  BEEN  INDEXED  FOR  THE  LOGICAL  VIEW  OR  BY 
ACIF 

Reason:  The  SAMBCH  print  request  specif3ring  the  SELECT  keyword  has  failed 
because  indexing  has  not  been  established  for  the  view. 

Action:  Establish  indexing  criteria  for  the  view  if  it  does  not  already  exist.  Re¬ 
index  or  re-archive  the  SYSOUT.  Be  aware  that  page  indexing  occurs  only  during 
archival 

NO  PAGES  FOUND  THAT  MATCH  THE  SELECTION  TEXT 

Reason:  The  SARBCH  print  request  specifying  the  SELECT  keyword  has  failed 
because  the  SELECT  text  ID  did  not  match  any  index  selection. 

Action:  Check  that  the  SELECT  text  and  index  selection  criteria  are  as  intended. 
The  SYSOUT  would  have  to  be  re-archived  if  the  page  indexing  criteria  is 
changed.  Be  aware  that  page  indexing  occurs  only  during  archival. 


USER  IS  NOT  AUTHORIZED  TO  PRINT  REPORT  FROM  HIS 
DESTINATION 

Reason:  The  SARBCH  print  request  has  failed  because  the  user  exit  SARDSTUX 
has  denied  the  request. 

Action:  See  your  system  administrator  or  specify  an  authorized  destination  for 
the  reprint. 
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ONLINE  PRINTING  TO  A  VTAM  PRINTER  EXCEEDED  THE 
MAXIMUM  PERMIHED  PRINT  LINES 

Reason:  Your  print  request  exceeded  the  maximum  number  of  lines  permitted 
during  online  VTAM  print  processing.  This  message  can  also  occur  on  nom 
VTAM  printers  as  an  indication  that  an  error  occurred  while  printing  on  both 
devices  simultaneously. 

Action:  Do  one  of  the  following: 

■  Print  in  smaller  segments. 

■  Increase  the  maximum  permitted  for  this  device  by  using  the  DEFine  DEVice 
facility. 

■  Increase  the  maximum  permitted  for  all  devices  by  using  SARINIT 
parameter  VPRTMAXO. 

■  Make  multiple  separate  print  requests. 


PRINTING  VIA  CMASPOOL  EXCEEDED  THE  MAXIMUM  PERMIHED 
PRINT  LINES 

Reason:  Your  print  request  exceeded  the  maximum  number  of  lines  permitted 
during  CA-Spool  print  processing.  This  message  can  also  occur  on  non- VTAM 
printers  as  an  indication  that  an  error  occurred  while  printing  on  both  devices 
simultaneously. 

Action:  Do  one  of  the  following: 

■  Print  in  smaller  segments. 

■  Increase  the  maximum' permitted  for  this  device  by  using  the  DEFine  DEVice 
facility. 

■  Increase  the  maximum  permitted  for  CA-Spool  devices  by  using  SARINIT 
parameter  CMAMAX. 

■  Make  multiple  separate  print  requests. 

ERROR  IN  DEFINE  DEVICE  RECORD 

Reason:  The  DEFine  DEVice  record  is  invalid.  This  could  be  caused  by  a  record 
which  was  not  completely  defined. 

Action:  Correct  the  DEFine  DEVice  record  and  retry. 
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REQUESTED  INDEX  NOT  FOUND 

Reason:  The  page  index  value  specified  on  the  SELECT  keyword  of  the  print 
request  was  not  found  for  the  requested  SYSOUT  group. 

Action:  Verify  that  the  correct  page  index  value,  SYSOUT  group,  and  view  are 
being  specified;  otherwise,  remove  the  SELECT  parameter,  then  print  the  entire 
SYSOUT  group. 


NO  TOR  RECORD  FOUND  FOR  REQUESTED  SYSOUT 

Reason:  An  attempt  is  being  made  to  print  a  SYSOUT  group  from  tape,  but 
certain  vital  backup  tape  control  information  cotdd  not  be  found. 

Action:  Normally,  tape  control  information  is  retained  as  long  as  there  are 
reports  that  reference  it.  The  tape  control  record  (TCR)  can  be  reinstated  by  re¬ 
adding  the  tape  back  into  the  database  with  the  TADD  facility  of  the  SARTDR 
utility. 

Important!  This  condition  could  identify  a  serious  problem  with  the  database  or 
problems  xoith  the  supporting  code.  Report  the  problem  to  Computer  Associates  Technical 
Support. 


ERROR  DURING  SECONDARY  DISK  OR  EAS  ACCESS 

Reason:  An  error  occurred  opening  a  report  on  optical  disk,  or  on  tape  accessed 
through  an  EAS  tape  server. 

Action:  Browse  the  report  online  to  see  any  error  messages  from  the  DSK2  driver 
or  EAS  tape  server  interface  routine. 


REPORT  SUCCESSFULLY  COMPLETED 

Reason:  The  listing  of  SYSOUT  groups  or  USERIDs  was  successfully  written  to 
the  REPORT  DD  statement 

Action:  None. 
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REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled' SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  list  process,  or  the  manual  deletion  of 
the  SYSOUT  group  by  using  the  online  retrieval  facility  or  batch  retrieval  facility 
(SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  groups.  If  the  SYSOUT  identifier 
(ID);  and/ or  generation  (GEN)  was  specified  incorrectly,  change  the  parameter 
specification,  tiien  resubmit  the  list  request. 


REQUESTED  USER(S)  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  user  ID  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  an  incorrect  specification  of  the  USER  parameter  or  the  user 
ID  was  already  deleted  by  another  job  or  user  by  using  the  online  retrieval  facility 
or  batch  retrieval  facility  (SARBCH). 

Action:  Verify  the  existence  of  the  user  ID.  If  the  user  ID  (USER  parameter)  was 
specified  incorrectly,  change  the  parameter  specification;  Aen  resubmit  the  list 
request. 


USER  KEYWORD  CONFLICTS  WITH  EXCP/GEN/ID/SEQ 
KEYWORD(S) 

Reason:  The  USER  parameter  cannot  be  specified  with  the  EXCP,  GEN,  ID, 
and/or  SEQ  parameter. 

Action:  Either  remove  the  USER  parameter  or  remove  the  EXCP,  GEN,  ID; 
and/ or  SEQ  parameters  from  the  control  statement,  then  resubmit  the  list 
request. 

USER  NOT  AUTHORIZED  TO  LIST  USERID(S) 

Reason:  The  USERID  extracted  by  the  SARUSBUX  utility  does  not  have 
sufficient  authority  (master  authority)  to  list  USERIDs  from  the  database.  The 
USERID  that  requires  authority  is  indicated  in  the  SARBCH05  message. 

Action:  Consult  your  seciuity  administrator  or  systems  programming  group  to 
determine  the  reason  why  the  authorization  was  not  provided. 
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REPORT  DD  STATEMENT  MISSING 


Reason:  The  REPORT  JCL  DD  statement  was  not  provided  and  is  required  for 
the  control  statement. 

Action:  Specify  the  REPORT  JCL  DD  statement,  then  resubmit  the  job. 


USER=user/d 
PASSWORDspossword 
MASTER=Y|N 
D\SlMASK-distid-mask 
D\ST\D=distid 
ACC^access-fo-modes 
MODE=current-mode 
BANNER=£>anner-name 
LANGUAGEs/on^uoge 
PmiER-printer 
PCLASS-class 
PDESUdest 
ACLASSsc/ass 
ADEST=desf 
JCLl  szsubmit-job-Jcll 
JCL2ssubmit-}ob-jel2 
JCL3=submit-job-Jcl3 
JCLA=submit-}ob-fcl4 

Reason:  This  message  identifies  the  profile  attributes  of  the  online  user  after 
processing  the  DEFUSER  request. 

Action:  None.  This  is  an  informational  message. 


USER  SUCCESSFULLY  ADDED 

Reason:  The  orvline  user  and  profile  attributes  were  successfully  added  to  the 
CA-View  database.  This  message  is  accompaiued  by  the  SARBeU02  message 
which  details  the  user  profile  informationi 

Action:  None. 
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SARBCU12 


SARBCU15 


SARBCU16 


USER  SUCCESSFULLY  MODIFIED 

Reason:  The  online  user  and  profile  attributes  for  an  existing  user  were 
successfully  changed.  This  message  is  accompanied  by  the  SARBCU02  message 
which  details  the  user  profile  information. 

Action:  None.  This  is  an  informational  message. 


SYSOUT/DISTID  SUCCESSFULLY  DEFINED 

Reason:  The  SYSOUT  and  DISTID  references  used  to  qualify  selection  of 
SYSOUT  for  online  users  in  SAR  mode  have  been  successfully  added  to  the 
CA-View  database. 

Action:  None.  This  is  an  informational  message. 


USER  NOT  AUTHORIZED  TO  PERFORM  DEFINE  FUNCTION 

Reason:  Master  authority  is  required  to  perform  the  DEFDIST,  DEFSYS,  or 
DEFUSER  request. 

Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  detennine  the  reasons  why  the  authorization  was  not  provided. 


MODE  MUST  BE  “ALL”,  “EXPO”,  “EXP”,  “SARO”,  OR  “SAR” 

Reason:  The  parameter  specification  for  the  MODE  keyword  on  the  DEFUSER 
control  statement  is  invalid.  The  acceptable  values  are  ALL,  EXPO,  EXP,  SARO, 
or  SAR. 

Action:  Correct  the  MODE  keyword  specification  on  the  DEFUSER  control 
statement,  then  resubmit  the  define  request. 


USERID  NOT  SUPPLIED 

Reason:  The  USER  keyword  was  not  specified,  or  a  user  ID  was  not  supplied 
with  the  USER  keyword.  The  USER  parameter  is  required  on  the  DEFUSER 
control  statement. 

Action:  Correct  or  add  the  USER  keyword  specification  on  the  DEFUSER  control 
statement  then  resubmit  the  define  request. 
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DISTID  DOES  NOT  CONFORM  TO  DISTID  MASK  SPECIFICATION 

Reasont  The  distributican  identifier  specified  on  the  DISTID  keyword  of  the 
DEFUSER  request  does  notmatch  the  masking  pattern  of  the  DISTID  mask. 

Action:  Either  change  the  distribution  identifier  on  the  DISTID  keyword  to 
conform  to  the  DISTID  mask  or  change  the  DISTID  mask  to  encompass  the 
specification  of  the  specified  distribution  identifier. 


ACCESS  TO  SPECIHED  MODE  DENIED  BY  ACCESS  INDICATORS 

Reason:  The  access  mode  specified  on  the  MODE  parameter  of  the  DEFUSER 
control  statement  is  not  accessible  based  on  the  access  mode  indicators  defined  to 
the  user. 

Action:  Either  change  the  access  mode  specified  on  the  MODE  parameter  to  an 
accessible  mode  or  change  the  access  mode  indicators  to  allow  access  to  the 
specified  access  mode. 


ACCESS  MODE  INDICATORS  INVALID 

Reason:  The  access  mode  indicator  specification  on  the  AGC  parameter  of  the 
DEFUSER  control  statement  is  not  valid.  The  access  mode  indicator  specification 
may  be  Y  or  N  for  each  of  the  five  access  modes,  ALL,  EXPO,  EXP,  SARG,  and 
SAR>  respectively. 

Action:  Correct  the  specification  of  the  access  mode  indicators  on  the  ACC 
parameter,  then  resubmit  the  define  request. 


USER  OR  SYSOUT  PARAMETER  NOT  SUPPLIED 

Reason:  The  USER  keyword  was  not  specified  on  the  DEFUSER  control 
statement,  or  the  SYSOUT  ke3Word  was  not  specified  on  the  DEFDIST  or 
DEFSYS  control  statement. 

Action:  Add  the  appropriate  keyword  specification  to  the  define  request,  then 
resubmit  the  request. 


DISTID  IS  MISSING  FOR  DEFINING  SYSOUT/DISTID 

Reason:  The  DISTID  keyword  was  not  specified  on  the  DEFDIST  or  DEFSYS 
control  statement  and  is  required. 
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Action::  Add  the  DISTID  ke5rword  specification  to  the  define  request,  then 
resubmit  the  request. 


I/O  ERROR 

Reason:  An  error  occurred  while  reading  or  writing  data  from  the  CA- View 
database.  This  message  should  be  accompanied  by  a  SARDBIicx  message 
indicating  the  nature  of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBItcx  message  for  resolution. 

INVALID  LANGUAGE  OR  ITS  PANELS  NOT  FOUND  IN  DATABASE 

Reason:  The  online  panels  for  the  specified  language  were  not  found  in  the 
CA-View  database.  When  the  LANGUAGE  ke5rword  is  specified  on  the 
DEFUSER  control  statement,  the  CA-View  database  is  queried  for  the  online 
member  name  SAxRPl,  where  x  is  the  language  specification.  This  error  message 
is  generated  when  that  online  member  is  not  found. 

Action:  Load  the  appropriate  language  panels  into  the  CA-View  database  or 
specify  a  language  that  is  defined  to  your  CA-View  database. 


USER  NOT  AUTHORIZED  TO  ACCESS  SYSOUT 

Reason:  The  SARSECUX  security  user  exit  did  not  allow  access  to  the  SYSOUT 
group. 


Action:  Consult  with  your  security  administrator  or  systems  programming 
group  to  determine  the  reasons  why  the  authorization  was  not  provided. 


ID  MISSING 

Reason:  The  ID  parameter  was  specified  without  a  SYSOUT  identifier,  which  is 
required  on  the  control  statement. 

Action:  Change  the  ID  parameter  to  include  the  SYSOUT  identifier  that  is  to  be 
extracted,  then  resubmit  the  extract  request. 


INBALANCE  EXTRACTION  PROGRAM  IS  NOT  INSTALLED  OR  IS 
NOT  AVAILABLE 

Reason:  The  CA-Balancing  extraction  program,  INBEXTP,  was  not  foimd. 
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Actioni  Ensure  that  the  INBEXTP  load  module  is  accessible  from  the  STEPLIB> 
JOBLIB;  or  the  linklist,  resubmit  the  request. 

IMBALANCE  EXTRACTION  COMPLETED  SUCCESSFULLY 

Reason:  The  CA-Balancing  extraction  for  the  request  SYSOUT  group  completed 
successfully. 

Action:  None. 


IMBALANCE  EXTRACTION  COMPLETED  (WARNING  MESSAGES 
WERE  ISSUED 

Reason:  The  CA-Balancing  extraction  completed,  but  there  were  warning 
messages  that  were  issued. 

Action:  Review  the  warning  message  to  determine  if  action  is  necessary. 

IMBALANCE  EXTRACTION  UNSUCCESSFUL 

Reason:  The  CA-Balancing  extraction  was  unsuccessful  due  to  a  previous  error. 
Action:  Refer  to  the  previous  error  to  determine  the  appropriate  action. 


REQUESTED  SYSOUT  NOT  FOUND  IN  MASTER  INDEX 

Reason:  The  requested  SYSOUT  group  does  not  exist  in  the  master  index.  This  is 
normally  caused  by  a  misspelled  SYSOUT  identifier,  a  backup  cycle  deleting  the 
SYSOUT  group  prior  to  completion  of  the  extract  process,  or  the  manual  deletion 
of  the  SYSOUT  group  by  using  the  online  retrieval  facility  or  batch  retrieval 
facUity  (SARBCH). 

Action:  Verify  the  existence  of  the  SYSOUT  group.  If  the  SYSOUT  identifier  (ID), 
generation  (GEN),  and/or  sequence  number  (SEQ)  was  specified  incorrectly, 
change  the  parameter  specification,  then  resubmit  the  load  request. 
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DATA  SET  NOT  LOADED  -  ALREADY  ON  DISK 

Reason:  The  SYSOUT  group  was  not  loaded  to  the  CA-View  database  because  it 
already  resides  on  disk.  Initial  processing  of  the  extract  request  determined  that 
the  SYSOUT  group  which  resides  on  tape  or  secondary  disk  must  be  loaded  to 
the  CA-View  database  to  perform  the  extraction.  Subsequently,  it  was 
determined  that  the  SYSOUT  group  was  reloaded  by  another  batch  or  online 
request. 

Action:  Resubmit  the  extract  request. 


REQUESTED  SYSOUT  DOES  NOT  EXIST  ON  ANY  TAPE  BACKUP 
DATA  SET 

Reason:  The  SYSOUT  group  could  not  be  found  on  any  tape  backup. 
Action:  None.  The  SYSOUT  group  is  not  available  on  tape. 


THE  TAPE  FILE  WAS  NOT  THE  SELECTED  SYSOUT  GROUP  -  USE 
SARTCP  TO  MAP  THE  TAPE 

Reason:  The  SYSOUT  group  located  on  the  backup  tape  is  not  the  same  as  the 
one  that  is  referenced  in  the  master  index. 

Action:  Use  the  SARTCP  utility  to  map  and  correct  the  backup  tape. 


BACKUP  TAPE  DOES  NOT  EXIST 

Reason:  The  backup  tape  could  not  be  found  in  the  master  index.  This  is 
normally  caused  by  the  backup  cycle  deleting  the  tape  prior  to  completion  of  the 
load  request. 

Action:  None.  The  SYSOUT  group  is  no  longer  available. 


DYNAMIC  ALLOCATION  FAILED  FOR  TAPE  FILE,  ERROR  CODE  - 
xxxx,  INFO  CODE  -  xxxx 

Reason:  Dynamic  allocation  failed  for  allocating  the  backup  tape  file.  The 
hexadecimal  error  and  information  codes  are  provided. 

Action:  Consult  the  online  retrieval  help  facility  for  a  description  of  the  d5mamic 
allocation  error  code.  Take  appropriate  action  to  correct  the  allocation  error,  then 
resubmit  the  extract  request. 
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I/O  ERROR  POSITIONING  TAPE 

Reason:  A  permanent  I/G  error  occurred  attempting  to  position  the  archival 
tape  to  retrieve  the  SYSOUT  group. 

Action:  Resubmit  the  request.  If  the  I/O  error  occurs  again,  use  the  SARTCP 
utility  to  map  and  correct  the  tape. 


SYSOUT  GROUP  IS  OPEN  FOR  OUTPUT 

Reason:  The  requested  function  could  not  be  perfonned  because  the  specified 
SYSOUT  group  is  open  for  output.  The  SYSOUT  group  can  be  in  open  status  due 
to  a  currently  pending  temporary  load  operation,  a  pending  migration  operation, 
or  initial  creation. 

Action:  Wait  until  die  status  of  the  SYSOUT  group  has  changed  from  open 
status,  then  resubmit  the  extract  request.  If  the  open  condition  is  invalid  (for 
example,  a  system  crash  or  an  abend  occurred  while  the  SYSOUT  group  was  in 
open  status  and  being  processed)  use  the  CLEAN  operator  command  to  remove 
the  open  status.  Two  backup  cycles  and  a  duration  of  four  hours  must  have 
elapsed  before  the  open  status  is  removed. 


PERMANENT  I/O  ERROR  ON  INPUT  TAPE 


Reason:  A  permanent  I/O  error  occurred  attempting  to  read  SYSOUT  data  from 
a  backup  tape. 

Action:  Resubmit  the  extract  request.  If  the  I/O  error  occurs  again,  use  the 
SARTCP  utility  to  map  and  correct  the  tape.  Also  see  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  recovery  procedures. 


{STANDARD  |  INTERIM}  BACKUP  CYCLE  STARTED  FOR  GEN  nnn 
ON  dddddddd  M  tttttm 

Reason:  A  CA-View  backup  cycle  has  been  initiated. 

Action:  None. 


SYSOUT  GROUP  xxxxxxxxxxxx  SKIPPED  DUE  TO  PREVIOUS  I/O 
ERROR 

Reason:  An  I/O  error  occurred  attempting  to  backup  the  specified  SYSOUT 
group.  The  remainder  cf  the  SYSOUT  group  is  skipped. 
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SARBKT53 
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Action:  Probably  none;  however,  verify  that  there  is  no  major  problem  with  the 
database. 


SYSOUT  GROUP  xxxxxxxxxxxx  NOT  DELETED  DUE  TO  PREVIOUS 
I/O  ERROR 

Reason:  An  I/O  error  occurred  attempting  to  delete  the  specified  SYSOUT 
group.  The  group  is  not  deleted. 

Action:  Probably  none;  however,  verify  that  there  is  no  major  problem  with  the 
database. 


‘“WARNING***  RUN  SARPAC  TO  COPY  TAPES  FOLLOWING 
MERGE  OF  DATABASES 

Reason:  The  database  contains  references  to  tape  voliomes  owned  by  another 
database.  This  condition  is  the  result  of  a  database  merge. 

Action:  Rim  SARPAG  to  copy  the  SYSOUT  groups  on  tape  to  new  tape  volumes 
owned  by  this  database. 


SYSOUT  ALLOCATION  ERROR  CODE  -  xxxx,  INFO  CODE  -  xxxx 

Reason:  A  dynamic  allbcation  request  for  allocating  the  print  data  set  to  SYSOUT 
failed.  The  hexadecimal  error  and  information  codes  are  provided. 

Action:  Determine  the  reason  for  the  failure  and  fix  the  problem,  then  resubmit 
the  job. 

RECOVERY  DATASET  FILE  ERROR  -  OPER=xxxx,  RC=nn 

Reason:  Error  attempting  to  access  the  recovery  data  set.  The  CA-View  backup 
cycle  is  terminated. 

Action:  None.  If  a  hardware  error  is  not  indicated.  Contact  Computer  Associates 
Technical  Support. 


NO  SARRECV  DD  STATEMENT  -  RECOVERY  DATASET  NOT 
UPDATED 

Reason:  There  is  no  DD  statement  for  the  backup  recovery  file  in  the  started 
task. 
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Action:  None,  if  you  wish  to  run  without  the  backup  recovery  file.  Otherwise, 
change  the  started  task  JCL  and  restart. 


ERROR  DETERMINING  IF  OPEN  SYSOUT  STILL  BEING  PROCESSED. 
RC-xx 

Reason:  The  CA-View  started  task  issues  the  lEFSSREQ  macro  to  verify  that  a 
SYSOUT  is  not  still  in  the  process  of  being  written  to  the  CA-View  database  when 
the  backup  cycle  attempts  to  migrate  it  off  disk.  The  lEFSSREQ  macro  had  a 
return  code  of 

Action:  See  the  IBM  documentation  for  return  codes  for  the  lEFSSREQ  macro. 


UNEXPECTED  lEFSSREQ  RETURN  CODE.  RC=xx 

Reason:  The  CA-View  started  task  issues  the  lEFSSREQ  macro  to  verify  that  a 
SYSOUT  is  not  still  in  the  process  of  being  written  to  the  CA-View  database  when 
the  backup  cycle  attempts  to  migrate  it  off  disk.  The  lEFSSREQ  macro  had  a 
return  code  of  xx.  Field  SSOBRETN  contained  an  unanticipated  value.  This  may 
be  caused  by  changes  to  JES  control  blocks  SSOB  and  SSCS. 

Action:  See  the  IBM  documentation  for  return  codes  for  the  lEFSSREQ  macro. 


SYSOUT  GROUP  xxxxxxxx  NOT  DELETED  DUE  TO  PREVIOUS 
ERROR 

Reason:  This  message  is  issued  after  message  SARBKT57  or  SARBKT58.  It 
indicates  that  the  identified  SYSOUT  sub-file  data  was  to  have  been  deleted  from 
disk  because  it  has  expired  via  the  NGEND  initialization  parameter  value. 
Because  the  attempt  to  verify  that  the  SYSOUT  group  was  not  still  being 
processed  failed,  it  will  not  be  deleted  from  disk. 

Action:  See  the  IBM  dccumentation  for  the  lEFSSREQ  return  code  indicated  in 
the  previously  issued  SARBKT57  or  SARBKT58  msg.  Possibly  use  the  DD  online 
command  to  manually  change  the  location  to  TAPE  in  order  to  free  the  allocated 
disk  space. 


SYSOUT  GROUP  xxxxxxxx  NOT  DELETED  SINCE  IT  IS  STILL  BEING 
PROCESSED 

Reason:  The  CA-View  started  task  discovered  a  SYSOUT  was  still  in  OPEN 
status,  issued  the  lEFSS^Q  macro  to  verify  whether  it  was  still  being  written  to 
disk,  and  it  was. 
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Action:  None.  If  the  message  pemists,  and  you  want  to  free  the  disk  space,  use 
the  G  online  command  to  change  the  location  from  OPEN  to  DISK.  With  the  next 
backup  cycle,  the  partial  SYSOUT  will  be  backed  up  to  tape  unless  you  delete  it 
first. 


{STANDARD  |  INTERIM}  BACKUP  CYCLE  STARTING  PHASE  n 

Reason:  This  message  identifies  which  internal  backup  phase  is  begirming.  Phase 
1  backs  up  the  current  generation)  to  tape  and  performs  ERO  processing.  Phase  2 
backs  up  the  master  index  to  tape,  deletes  expired  reports,  and  imcatalogs 
expired  tapes. 

Action:  None.  This  is  an  informational  message. 


{STANDARD  |  INTERIM}  BACKUP  CYCLE  ENDING  PHASE  n 
OF  nnn  REPORTS  ON  DATABASE,  nnn  WERE  PROCESSED 

Reason:  This  message  identifies  which  internal  backup  phase  is  ending.  The 
number  of  reports  on  the  database  includes  those  whiA  are  not  currently  on 
DASD  (they  are  on  tape).  The  number  processed  only  includes  those  in  the 
current  generation.  Because  archiving  may  continue  during  the  backup,  these 
numbers  may  change  from  backup  phase  to  backup  phase. 

Action:  None.  This  is  an  informational  message. 


{STANDARD  |  INTERIM}  PHASE  n  PROCESSING  rrrrrr,  ARCHIVED 
ON  ddddAl  fftt 

Reason:  This  message  is  a  progress  report  issued  during  a  backup.. It  appears  at 
intervals  specified  by  the  SARINIT  parameter  DBMSGFRQ. 

Action:  None.  This  is  an  informational  message. 


UNABLE  TO  DELETE  SYSOUT  GROUP  xxxxxxxx  FROM 
SECONDARY  DISK 

Reason:  An  error  occurred  attempting  to  delete  the  report  form  optical  disk. 
Action:  Verify  that  the  optical  device  is  functioning  properly. 
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stof-group-nome  STORAGE  GROUP  IS  BEING  COPIED  TO  TAPE 

Reason;  The  named  storage  group  is  being  copied  from  disk  to  tape.  STORGRPO 
is  named  DEFAULT  by  CA-View. 

Action:  None.  This  is  an  informational  message. 


BACKUP  CYCLE  ENDED  FOR  GEN  nnn  ON  dddddddd  AT  fttftttt 

Reason:  Backup  cycle  ended. 

Action:  None.  This  is  an  informational  message. 


SARBia9A  CURRENT  GENERATION  IS  {NOW  |  STILL}  nnn 

Reason;  Issued  in  conjxmction  with  SARBKT99  to  advise  you  of  current  archival 
generation  and  whether  the  generation  mnnber  has  changed  as  a  result  of  the  just 
completed  backup. 

Action:  None.  This  is  an  informational  message. 

O  SARBKU02  DIRECT  TO  TAPE  ARCHIVAL  SUSPENDED  FOR  COMPLETION  OF 

BACKUP  CYCLE 

Reason:  Direct-to-tape  archival  must  be  suspended  until  the  backup  cycle  has 
completed. 

Action:  None.  Direct-to-tape  archival  wUl  resiune  following  completion  of  the 
backup  cycle. 


SARBKU03  ARCHIVAL  SUSPENDED  FOR  COMPLETION  OF  BACKUP  CYCLE 

Reason;  Another  backup  cycle  has  been  started,  possibly  by  the  operator  or  due 
to  insufficient  storage,  etc.  SYSOUT  archival  must  be  suspended  until  the  backup 
cycle  has  completed. 

Action:  None.  This  is  an  informational  message. 
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TERMINATION  SUSPENDED  FOR  COMPLETION  OF  BACKUP 
CYCLE 

Reason:  The  operator  has  attempted  to  stop  SAR  with  a  P  command.  The 
SYSOUT  archival  terminatibn  must  be  suspended  until  the  backup  cycle  has 
completed. 

Action:  None.  This  is  an  informational  message. 


{STANDARD  |  INTERIM}  BACKUP  BYPASSED  PER  STACKBU=NO 

Reason:  The  request  for  the  type  of  backup  indicated  (standard  or  interim)  has 
been  ignored  since  to  honor  it  would  cause  multiple  backups  to  queue  andiyou 
have  specified  STACKBU=NO  as  an  initialization  parameter. 


Action:  None. 


database-name  BACKUP  BYPASSED  DUE  TO  RECOVERY 
PROCESS 

Reason:  The  backup  cycle  is  bypassed  because  a  SARDBASE  RESTORE 
operation  is  in  progress.  The  backup  cycle  scratches  the  old  recovery  files  and 
creates  new  ones,  but  SARDBASE  RESTORE  is  reading  the  old  recovery  files. 

Action:  None.  This  is  an  informational  message. 


BACKUP  CYCLE  IS  RUNNING  -  REPLY  W  (WAIT)  TO  WAIT  FOR  IT 
TO  COMPLETE  OR  T  (TERMINATE) 

Reason:  You  have  attempted  to  stop  the  backup  cycle  with  a  P  operator 
coirunand.  This  message  gives  you  the  option  of  having  CA-View  terminate  its 
backup. 


Warning!  it  \  OU  ha%  k  CA-\  lev'  Itmunate  its  oackup  it  ill  Lcntinu^.  troni 
where  it  left  otf  the  next  time  it  is  brought  up  This  is  a  I'unsidcralion  it  you 
art  using  a  tape  manageminl  system,  and  t  anc i  ling  a  tape  backup  job  i  o  I’d 
re-^ult  in  the  tape  being  scratched. 


Action:  Reply  W  to  let  the  backup  cycle  complete  running,  or  T  to  terminate  it. 


***********  **********  A'*  *  ********  W  **  ir  ****  ***  **  4r  **  W 
*  * 
*  BACKUP  ABENDED  WITH  CODE  XSOQE  * 
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******************************************************* 


Reason:  The  CA-View  backup  cycle  has  abended.  The  system  or  user  abend  code 
is  provided. 

Action:  Consult  the  IBM  MVS  System  Codes  manual  to  determine  the  reason  for 
the  abend.  If  you  still  cannot  determine  the  problem,  contact  Computer 
Associates  TechnicalSupport. 


ALLOCATION  FAILED  FOR  SYSOUT  DATASET,  ERR=xxxx, 
INFO=xxxxxx 

Reason:  CA-View  was  notable  to  allocate  space  for  the  SYSOUT  data  set 
indicated  in  the  error  message. 

Action:  Correct  and  retry. 

NO  DISTRIBUTION  IDENTIFIERS  FOR  BUNDLE 

Reason:  No  distribution  identifiers  for  the  report  exist. 

Action:  Correct  and  retry. 

NO  REPORTS  DEFINED  FOR  DISTRIBUTION  IDENTIFIER 

Reason:  No  reports  exist  for  the  distribution  identifier. 

Action:  Correct  and  retry. 

THE  TAPE  CONTAINED  A  NULL  FILE  FOR  THE  SYSOUT  GROUP 

Reason:  A  file  on  the  moimted  tape  is  nuUi 
Action:  Correct  and  retry. 

THE  TAPE  FILE  WAS  NOT  THE  SELECTED  GROUP  -  USE  SARTCP  TO 
MAP  THE  TAPE 

Reason:  The  file  specified  is  not  the  selected  group. 

Action:  Correct  and  retry. 
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SARBPT07 


SARBPT08 


SARBPT09 


SARBPTIO 


SARBPTl  1 


SARBPT12 


SARCICOl 


BACKUP  TAPE  DOES  NOT  EXIST 

Reason;  The  backup  tape  specified  does  not  exist. 

Action:  Correct  and  retry. 

TAPE  ALLOCATION  ERROR  CODE  -  xxxx,  INFO  CODE  -  xxxx 

Reason:  Tape  allocation  was  not  possible  because  of  reasons  referenced  by  code. 
Action:  Correct  and  retry. 

I/O  ERROR  POSITIONING  TAPE 

Reason;  1/ O  was  not  possible  because  of  error  positioning  the  tape. 

Action:  Correct  and  retry. 

SYSOUT  GROUP  IS  OPEN  FOR  OUTPUT 

Reason:  The  SYSOUT  group  specified  is  open  for  output. 

Action:  Correct  and  retry. 

//  OUTPUT  FAILED  FOR  SYSOUT,  REASON=xxxx 

Reason:  The  attempt  to  dynamically  create  a  /  /  OUTPUT  statement  failed.  The 
hexadecimal  reason  code  is  provided. 

Action:  Correct  and  retry. 

PERMANENT  I/O  ERROR  ON  INPUT  TAPE 

Reason;  A  permanent  I/O  error  occurred  when  reading  the  tape. 

Action;  Use  SARTCP  to  correct  the  problem  with  the  tape. 

CA-VIEW  2.0  TERMINATED 

Reason;  SYSOUT  archival  was  terminated. 

Action:  None. 
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SARCIFOl 


SARCIF02 


SARCIF03 


SARCIF04 


CA-VIEW  2.0  ABENDED 

Reason:  The  CA-View  GICS  conversational  interface  has  abended: 
Action:  Contact  Computer  Associates  Technical  Support. 


INVALID  INDEX  BLOCK, DCCB=nnnn 

Reason:  An  invalid  index  block  was  encountered  when  attempting  to  reorganize 
the  index  file  of  the  database. 

Action:  Correct  the  problem  with  the  database.  This  may  require  running 
SARDBASE  VERIFY,  or  performing  other  recovery  functions  against  it. 


REORG  HAS  PROCESSED  TO  KEY=x 

Reason:  This  is  an  informational  message,  periodically  issued  to  indicate  the 
progress  of  an  asynchronous  SARDBASE  REORG. 

Action:  None.  This  is  an  informational  message. 

RECOVERED  INDEX  BLOCKS  =  n 

Reason:  This  is  an  mformational  message  that  specifies  the  number  of  empty 
blocks  in  the  index  file  that  have  been  recovered  by  an  asynchronous  SARDBASE 
REORG. 

Action:  None. 


REORG  ENDED  AT  KEY=c/Otofoose  key 

Reason:  A  stop  command  was  issued  during  processing  the  SARDBASE 
asynchronous  REORG.  This  message  indicates  where  the  asynchronous  REORG 
ended. 

Action:  None.  This  is  an  informational  message. 
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SARCMA01 


SARCMA02 


SARCMA03 


SARCMA04 


CMASPOOL  fffff  FAILED  ON  dddddddd,  RC=rr  ppp  W 

Reason:  This  message  is  issued  when  CA^Spool  rejected  a  request  made  by 
CA-View  in  an  imexpected  fashion  (no  other  more  specific  error  message 
app]ies)._;^is  the  function;  which  can  be  OPEN,  WMTE,  or  CLOSE,  dddddddd  is 
the  target  CA-Spool  device,  rris  the  CA-Spool  return  condition  found  in 
CA-Spool  parameter  list  field  ©OPENSTA.  ppp  is  only  present  when  the  error  is 
an  invalid  CA-Spool  parameter  list,  and  identifies  the  unacceptable  parameter  as 
found  in  CA-Spool  parameter  list  field  ©OPENPID. 

Action:  Check  the  CA-Spool  documentation  for  the  return  condition  that  was 
found. 


CMASPOOL  NOT  AVAILABLE  FOR  dddddddd 

Reason:  CA-Spool  rejected  a  CA-View  open  request  because  the  CA-Spool 
subsystem  is  not  available,  dddddddd  is  the  target  CA-Spool  device. 

Action:  Bring  up  the  CA-Spool  subsystem.  If  the  problem  still  occurs,  verify  that 
the  SARINIT  parameter  CMASPGOL=  has  the  same  value  as  the  CA-Spool 
ESFPARM  parameter  SUBID=.  If  you  are  using  the  CA-View  DEFine  DEVice 
facility,  and  have  overridden  the  SARINIT  CMASPOOL  parameter  by  specifying 
SUB-SYSTEM  ID,  then  it  must  be  the  same  as  the  CA-Spool  ESFPARM  SUBID= 
parameter. 


CMASPOOL  FULL  FOR  dddddddd 

Reason:  The  CA-SpooI  database  is  full,  dddddddd  is  the  target  CA-Spool  device. 

Action:  Make  room  in  the  CA-Spool  database  by  either  waiting  for  SYSOUT  to 
finish  printing,  deleting  items,  or  making  the  database  larger. 


CMASPOOL  DEVICE  dddddddd  DO£S  NOT  EXIST 

Reason:  You  are  trying  to  print  to  a  device  which  is  not  defined  to  CA-Spool. 
dddddddd  is  the  target  CA-Spool  device. 

Action:  Specify  a  device  already  defined  to  CA-Spool,  or  define  the  new  device 
to  CA-Spool. 
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SARCMA05 


SARCMA06 


SARCPIOl 


SARCPI02 


SARCPI03 


SARCPI04 


CMASPOOL  INTERFACE  PROGRAM  NOT  LINK  EDITED  FOR 
dddddddd 

Reason:  The  installaticai  of  the  CA-View-to-CA-Spool  interface  was  not  finished. 
It  requires  a  link-edit  of  the  AESFPRIV  routine  provided  on  the  user's  GA-Spool 
distribution  tape  into  the  SARCMAIX  program  provided  on  the  CA-View 
distribution  tape,  dddddddd  is  the  target  CA-Spool  device. 

Action:  Finish  the  installation. 


CMASPOOL  INVALID  INTERNAL  REQUEST  FOR  dddddddd 

Reason:  CA-View  posted  an  imacceptable  request  code  to  CA-Spool.  ddddddcid  is 
the  target  CA-Spool  device. 

Action:  Contact  Computer  Associates  Technical  Support. 


SYSOUT  IS  NOT  ON  PRIMARY  DISK 

Reason:  A  SYSOUT  must  be  on  primary  disk  to  be  indexed. 

Action:  Reload  the  SYSOUT  to  disk  (Online  L  Command  or  SARBCH  LOAD), 
then  resubmit  the  index  request. 


NO  INDEX  SPECIFIED  FOR  THIS  SYSOUT 

Reason;  No  page  separation  criteria  was  specified  with  any  logical  view  for  this 
SYSOUT. 

Action:  Specify  the  desired  page  separation  criteria  online,  with  at  least  one 
logical  view  definition. 


ERROR  OPENING  THE  SYSOUT  SUBFILE 

Reason;  An  I/O  error  c-ccurred  opening  the  SYSOUT. 
Action:  Report  the  problem  to  your  CA-View  administrator. 

I/O  ERROR  READING  SYSOUT 


Reason:  An  I/O  error  cccurred  reading  the  SYSOUT. 


Action:  Report  the  problem  to  your  CA-View  administrator. 
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SARCPI05 


SARCPI06 


SARCPI07 


SARCPIG8 


SARCPI09 


SARCPIIO 


SARCPIl  1 


CANNOT  ALLOCATE  SUBFILE  FOR  THE  NEW  PAGE  INDEX 

Reason:  The  database  is  possibly  out  of  space. 

Action:  Run  SARDBASE  STATUS,  to  check  the  percentage  of  utilization  of  the 
database.  If  the  utilization  is  very  high,  report  the  problem  to  yoiir  CA-View 
administrator  for  appropriate  action. 


ERROR  WRITING  LAST  BLOCK  OF  NEW  PAGE  INDEX 

Reason:  An  I/O  error  occurred  writing  the  page  index,  possibly  because  the 
database  is  out  of  space. 

Action:  Report  the  problem  to  your  CA-View  administrator. 

ERROR  UPDATING  GROUP  CONTROL  RECORD 

Reason:  An  I/O  error  occurred  updating  the  SYSOUT  Group  Control  Record. 
Action:  Report  the  problem  to  your  CA-View  administrator. 

ERROR  DELETING  OLD  PAGE  INDEX 

Reason:  An  I/O  error  occurred  when  deleting  the  old  page  index. 

Action:  Report  the  problem  to  your  CA-View  administrator. 

NEW  PAGE  INDEX  HAS  BEEN  CREATED 

Reason:  A  new  page  index  has  been  created. 

Action:  None.  This  is  an  informational  message. 

ERROR  REWRITING  GROUP  CONTROL  RECORD 

Reason:  An  I/O  error  occurred  rewriting  the  SYSOUT  Group  Control  Record. 
Action:  Report  the  problem  to  your  CA-View  administrator. 


ERROR  WRITING  PAGE  INDEX  TO  NEW  SUBFILE 

Reason:  The  database  is  possibly  out  of  space. 
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SARCPn2 


SARCPIia 


SARCSTOl 


SARCST02 


SARCTEOl 


SARCTE02 


Action:  Run  SARDB ASE  STATUS,  to  check  the  percentage  of  utilization  of  the 
database. 


ERROR  READING  THE  MASTER  DATABASE  INDEX 

Reason:  A  database  I/O  error  occurred. 

Action:  Report  the  problem  to  your  CA-View  administrator. 


CANNOT  CREATE  NEW  PAGE  INDEX  FOR  ACIF  SYSOUT 

Reason:  An  AFP  report,  archived  using  the  AFP  Conversion  and  Indexing 
Facility  (ACIF),  carmot  be  indexed  by  SARBCH  DSJDEX. 

Action:  AFP  reports  are  indexed  with  ACIF  index  control  statements.  See 
Indexing  AFP  Reports  in  Chapter  5,  "Archival,"  for  more  information. 


CICS  SUBTASK  STARTED 

Reason:  The  CICS  interface  subtask  has  been  started. 

Action:  None.  This  is  an  informational  message. 

CICS  SUBTASK  ENDED 

Reason;  The  CICS  interface  subtask  has  ended. 

Action:  None.  This  is  an  informational  message. 

SUBTASK  IS  NOT  ACTIVE 

Reason:  A  request  has  been  made  to  deactivate  the  CA-View  CICS  subtask,  but 
the  subtask  is  already  inactive. 

Action:  None. 

ACTIVE  SESSIONS  USING  SUBTASK  -  ENTER  Y/N  TO  FORCE 
TERMINATION 

Reason:  A  request  has  been  made  to  deactivate  the  CA-View  CICS  subtask,  but 
active  users  were  foxmd. 
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SARCTEG3 


SARCTE04 


SARD0001 


SARDQ002 


SARD0005 


SARD0006 


Action:  Enter  Y  to  force  termination,  or  N  to  cancel  subtask  inactivation. 

SUBTASK  NOT  TERMINATED 

Reason:  Unable  to  terminate  the  GIGS  interface  subtask. 

Action:  Gorrect  the  problem  and  retry. 

SUBTASK  SUCCESSFULLY  TERMINATED 

Reason:  The  GIGS  interface  subtask  has  been  successfully  terminated. 

Action:  None.  This  is  an  informational  message. 

INVALID  INDEX  NAME 

Reason:  The  index  prefix  in  the  DSK2PARM  initialization  parameter  is  invalid. 

Action:  Gorrect  the  value. 

INVALID  UNIT  NAME  (  5 

Reason:  The  unit  name  in  the  E>SK2PARM  initialization  parameter  is  invalid. 

Action:  Gorrect  the  value. 

INVALID  BLKSIZE 

Reason:  The  block  size  in  lire  DSJC2PARM  initialization  parameter  is  invalid. 

Action:  Gorrect  the  value. 

CATALOG  ERROR  RO-xxxx.xxxx.xxxx,  DSNsdsname 

Reason:  A  catalog  management  error  was  received  when  attempting  to  catalog 
the  data  set.  The  decimal  value  of  registers  15, 0,  and  1  are  provided. 

Action:  Determine  the  reason  for  the  catalog  error,  then  correct  the  problem. 


■  i 
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SARD0007 


SARD0008 


SARD0009 


SARD0010 


SARD0011 


SARD0013 


NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  The  optical  disk  device  cannot  be  accessed  directly  from  \^/GMS. 

Action:  Use  the  L  selection  code  to  submit  a  batch  job  to  temporarily  load  the 
SYSOUT  group  to  primary  disk  so  it  can  be  accessed. 


END  OF  DATA 

Reason:  An  tmexpected  end  of  data  condition  was  encountered  when  accessing 
the  SYSOUT  group  on  secondary  disk  storage.  This  condition  should  never 
happen. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


SYSOUT  GROUP  IS  NOT  ON  SECONDARY  DISK  STORAGE 

Reason:  The  SYSOUT  group  is  identified  in  the  master  index  as  residing  on 
secondary  disk  storage,  but  it  could  not  be  formd  there. 

Action:  Delete  the  disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be 
accessed. 


SYSTEM  ABEND  XXX  CREATING  DSNsdsnome 

Reason:  The  driver  was  abnormally  terminated  by  the  system  when  attempting 
to  create  a  data  set.  The  abend  code  is  provided. 

Action:  Determine  the  reason  for  the  abnormal  termination  and  correct  the 
problem. 


DYNAMIC  ALLOCATION  ERR=xxx,INFO=xxxx.DSN=cfena/TJe 

Reason:  A  d3mamic  allocation  request  for  allocating  a  data  set  failed.  The  ■ 
hexadecimal  error  and  information  codes  are  provided. 

Action:  Determine  the  reason  for  the  allocation  failure  and  correct  the  problem. 


LOGICAL  ERROR  PROCESSING  DSN=c/sname 

Reason:  The  internal  format  of  the  archived  SYSOUT  group  is  in  error  and 
cannot  be  used. 
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SARD0101 


SARD0102 


SARD0103 


SARD0104 


SARD0105 


SARD0106 


Action:  Delete  and  re-archive  the  SYSOUT  group. 


INVALID  UNIT  NAME 

Reason:  The  unit  name  in  the  DSK2PARM  initialization  parameter  is  invalid. 
Action:  Correct  the  value. 


INVALID  LOW  VOLSER 

Reason:  The  low  or  high  volume  serial  number  in  the  DSK2P ARM  initialization 
parameter  is  invalid. 

Action:  Correct  the  value. 

INVALID  HIGH  VOLSER 

Reason:  The  low  or  high  volume  serial  number  in  the  DSK2PARM  initialization 
parameter  is  invalid. 

Action:  Correct  the  value. 

LOW/HIGH  VOLSER  SPECIFIED  WITHOUT  THE  OTHER 

Reason:  Only  one  volume  serial  number  for  the  range  of  volume  serial  numbers 
in  the  DSK2P ARM  initialization  parameter  was  specified. 

Action:  Specify  both  volume  serial  numbers  for  the  range. 


LOW/HIGH  VOLSER  DOES  NOT  END  WITH  A  NUMERIC 

Reason:  Either  the  low  or  high  volume  serial  was  specified  without  a  numeric 
character  as  its  last  character. 

Action:  Review  and  correct  the  specified  volume  serial. 


LOW  AND  HIGH  VOLSERS  ARE  DIFFERENT  FORMATS 

Reason:  When  specifying  a  range  of  voliune  serial  ntunbers  in  the  DSK2PARM 
initialization  parameter,  the  voliune  serial  numbers  must  be  the  same  format. 

Action:  Correct  the  volume  serial  numbers. 
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SARD0107 


SARD0108 


SARD0109 


SARD01 1 1 


SARD0120 


SARD0121 


NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  The  optical  disk  device  cannot  be  accessed  directly  from  VM/CMS. 

Action:  Use  the  L  selection  code  to  submit  a  batch  job  to  temporarily  load  the 
SYSOUT  group  to  primary  disk  so  it  can  be  accessed. 


END  OF  DATA 

Reason:  An  unexpected  end  of  data  condition  was  encoimtered  when  accessing 
the  SYSOUT  group  on  secondary  disk  storage. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


SYSOUT  GROUP  IS  NOT  ON  SECONDARY  DISK  STORAGE 

Reason:  The  SYSOUT  group  is  identified  in  the  master  index  as  residing  on 
secondary  disk  storage,  but  it  could  not  be  found  there. 

Action:  Delete  the  disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be 
accessed. 

ERROR  PROCESSING  OUTPUT  FILE  ON  SECONDARY  DISK 

Reason:  An  error  occurred  when  writing  to  the  optical  disk  device. 

Action:  Correct  the  problem  with  the  optical  disk  device. 


SYSOUT  GROUP  NOT  FOUND 

Reason:  The  SYSOUT  group  has  been  deleted  by  another  user  between  the  time 
the  selection  list  was  created  and  the  time  you  made  your  request  to  access  the 
SYSOUT  group. 

Action:  None.  The  SYSOUT  group  is  no  longer  archived. 


DYNAMIC  ALLOCATION  ERR=xxx>c,  INFO=xx>cx 

Reason:  A  dynamic  allocation  request  for  allocating  the  secondary  disk  storage 
copy  failed.  The  hexadecimal  error  and  information  codes  are  provided. 

Action:  Determine  the  reason  for  the  allocation  failure  and  correct  the  problem. 
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SARD0122 


SARD0123 


SARD0201 


SARD0202 


SARD0203 


SARD0204 


POSITIONING  ERROR 

Reason:  An  error  occurred  attempting  to  position  the  secondary  disk  storage 
emulation  tape  to  retrieve  the  SYSOliJT  group. 


Action:  Resubmit  the  request.  If  the  problem  occurs  again,  then  the  SYSOUT 
group  can  no  longer  be  accessed  from  secondary  disk.  You  may  then  delete  the 
disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be  accessed. 


I/O  ERROR  ON  SECONDARY  DISK 

Reason:  An  1/ O  error  occurred  attempting  to  access  the  secondary  disk  storage 
emulation  tape. 

Action:  Resubmit  the  request.  If  ttie  problem  occurs  again,  then  the  SYSOUT  . 
group  can  no  longer  be  accessed  from  secondary  disk.  You  may  then  delete  the 
disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be  accessed. 


INVALID  INDEX  NAME 

Reason:  The  index  prefix  in  the  DSK2PARM  initialization  parameter  is  invalid. 
Action:  Correct  the  value. 


INVALID  ACCOUNT  NUMBER 

Reason:  The  account  identification  code  in  the  DSK2PARM  initialization 
parameter  is  invalid. 

Action:  Correct  the  value. 


INVALID  ACCOUNT  PASSWORD 


Reason:  The  accoimt  password  in  the  DSK2PARM  initialization  parameter  is 
invalid. 


Action:  Correct  the  value. 

INVALID  STORAGE  MACHINE  ID 


Reason:  The  storage  machine  identifier  in  the  DSK2P ARM  initialization 
parameter  is  invalid. 
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SARD0205 


SARD0207 


SARD0208 


SARD0209 


SARD0301 


Action:  Correct  the  value. 


UNABLE  TO  LOCATE  LSMCALL 

Reason:  When  loading  the  FileTek  Callable  Interface,  module  LSMCALL  could 
not  be  foimd. 

Action:  Verify  that  the  FileTek  Callable  Interface  library  is  available  to  the  step. 

NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  The  optical  disk  device  caimot  be  accessed  directly  from  VM/CMS. 

Action:  Use  the  L  selection  code  to  submit  a  batch  job  to  temporarily  load  the 
SYSOUT  group  to  primary  disk  so  it  can  be  accessed. 


END  OF  DATA 

Reason:  An  unexpected  end  of  data  condition  was  encormtered  when  accessing 
the  SYSOUT  group  on  secondary  disk  storage.  This  condition  should  never 
happen. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


SYSOUT  GROUP  IS  NOT  ON  SECONDARY  DISK  STORAGE 

Reason:  The  SYSOUT  group  is  identified  in  the  master  mdex  as  residing  on 
secondary  disk  storage,  but  it  could  not  be  found  there. 

Action:  Delete  the  disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be 
accessed. 

INVALID  INDEX  NAME 

Reason:  The  index  prefix  in  the  DSK2PARM  initialization  parameter  is  invalid. 
Action:  Correct  the  value. 
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SARD0302 


SARD0303 


SARD0304 


SARD0305 


SARD0307 


SARD0308 


INVALID  ACCOUNT  NUMBER 


Reason:  The  account  identification  code  in  the  DSK2PARM  initialization 
parameter  is  invalid. 

Action:  Correct  the  value. 

INVALID  ACCOUNT  PASSWORD 


Reason:  The  account  password  in  the  DSK2P ARM  initialization  parameter  is 
invalid. 

Action:  Correct  the  value. 


INVALID  STORAGE  MACHINE  ID 

Reason:  The  storage  machine  identifier  in  the  DSK2PARM  initialization 
parameter  is  invalid. 

Action:  Correct  the  value. 


UNABLE  TO  LOCATE  LSVICALL 

Reason:  When  loading  the  FileTek  Callable  Interface,  module  LSMCALL  could 
notbefoimd. 

Action:  Verify  that  the  FileTek  Callable  Interface  library  is  available  to  the  step. 


NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  The  optical  disk  device  cannot  be  accessed  directly  from  VM/CMS. 

Action:  Use  the  L  selection  code  to  submit  a  batch  job  to  temporarily  load  the 
SYSOUT  group  to  primary  disk  so  it  can  be  accessed. 


END  OF  DATA 

Reason:  An  imexpected  end  of  data  condition  was  encoimtered  when  accessing 
the  SYSOUT  group  on  secondary  disk  storage.  This  condition  should  never 
happen. 


Action:  Delete  and  re-archive  the  SYSOUT  group. 
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SARD0309 


SARD0313 


SARD0401 


SARD0402 


SARD0403 


SARD0404 


SYSOUT  GROUP  IS  NOT  ON  SECONDARY  DISK  STORAGE 

Reason:  The  SYSOUT  group  is  identified  in  the  master  index  as  residing  on 
secondary  disk  storage,  but  it  could  not  be  found  there. 

Action:  Delete  the  disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be 
accessed. 

LOGICAL  ERROR  PROCESSING  DSU=dsname 

Reason:  The  internal  format  of  the  archived  SYSOUT  group  is  in  error  and 
cannot  be  used. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


INVALID  UNIT  NAIVE 

Reason:  The  unit  name  in  the  DSK2PARM  initialization  parameter  is  invalid. 
Action:  Correct  the  value. 

INVALID  LOW  VOLSER 

Reason:  The  low  or  high  volume  serial  number  in  the  DSK2PARM  initialization 
parameter  is  invalid. 

Action:  Correct  the  value. 


INVALID  HIGH  VOLSER 

Reason:  The  low  or  high  volxxme  serial  number  in  the  DSK2PARM  mitialization 
parameter  is  invalid. 

Action:  Correct  the  value. 

LOW/HIGH  VOLSER  SPECIFIED  WITHOUT  THE  OTHER 

Reason:  Only  one  volume  serial  number  for  the  range  of  volume  serial  numbers 
in  the  DSK2PARM  initialization  parameter  was  specified. 

Action:  Specify  both  volume  serial  numbers  for  the  range. 


Diagnostic  and  Error  Messages  12-107 


Diagnostic  and  Error  Messages 


SARD0405 


SARD0406 


SARD0407 


SARD0408 


SARD0409 


SARD041 1 


LOW/HIGH  VOLSER  DOES  NOT  END  WITH  A  NUMERIC 

Reason:  Either  the  low  or  high  volume  serial  was  specified  without  a  numeric 
character  as  its  last  character.. 

Action:  Review  and  correct  the  specified  volume  serial 


LOW  AND  HIGH  VOLSERS  ARE  DIFFERENT  FORMATS 

Reason:  When  specifying  a  range  of  volume  serial  numbers  in  the  DSK2PARM 
initialization  parameter,  the  volume  serial  numbers  must  be  of  the  same  format. 

Action:  Correct  the  volume  serial  numbers. 

NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  The  optical  disk  device  cannot  be  accessed  directly  from  VM/CMS. 

Action:  Use  the  L  selection  code  to  submit  a  batch  job  to  temporarily  load  the 
SYSOUT  group  to  primary  disk  so  it  can  be  accessed. 


END  OF  DATA 

Reason;  An  unexpected  end  of  data  condition  was  encormtered  when  accessing 
the  SYSOUT  group  on  secondary  disk  storage. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


SYSOUT  GROUP  IS  NOT  ON  SECONDARY  DISK  STORAGE 

Reason:  The  SYSOUT  group  is  identified  in  the  master  index  as  residing  on 
secondary  disk  storage,  but  it  could  not  be  foimd  there. 

Action:  Delete  the  disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be 
accessed. 

ERROR  PROCESSING  OUTPUT  FILE  ON  SECONDARY  DISK 

Reason:  An  error  occurred  when  writing  to  the  optical  disk  device. 

Action:  Correct  the  problem  with  the  optical  disk  device. 
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SARD0413 


SARD0414 


SARD0420 


SARD0421 


SARD0501 


SARD0502 


UNABLE  TO  LOAD  MDRSCALL 

Reason:  When  loading  MDRS,  the  MDRSCALL  module  could  not  be  foxmd. 
Action:  Verify  that  the  MDRS  library  is  available  to  the  step. 


INVALID  MDRS  SUBSYSTEM  ID 

Reason:  The  specified  subsystem  ID  is  not  defined  to  MDRS  for  a  connected 
optical  disk  device. 

Action:  Check  that  the  specified  subsystem  ID  is  correct  for  the  desired  optical 
disk  device. 


SECONDARY  DISK  VOLUME  NOT  FOUND 

Reason:  The  requested  emulated  tape  volume  could  not  be  found  on  the  optical 
disk  device.  This  condition  could  occur  if  the  tape  volume  was  deleted  before 
your  request  for  access. 

Action:  Check  the  requested  volume  serials  for  validity. 


MDRS  INTERFACE  ERROR  RC^xxxx 

Reason;  The  Data/Ware  MDRS  interface  has  encoimtered  an  error. 

Action:  Consult  your  Data/ Ware  MDRS  documentation  for  the  meaning  of  the 
return  code. 

INVALID  INDEX  NAME 

Reason:  The  index  prefix  in  the  DSK2P ARM  initialization  parameter  is  invalid. 
Action:  Correct  the  value. 


INVALID  STORAGE  CLASS 

Reason:  The  storage  class  in  the  DSK2P ARM  initialization  parameter  is  invalid. 
Action:  Correct  the  value. 
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SARD0503 


SARD0504 


SARD0506 


SARD0507 


SARD0508 


SARD0509 


INVALID  MANAGEMENT  CLASS  LJ 

Reason:  The  management  class  in  the  DSK2PARM  initialization  parameter  is 
invalid. 

Action:  Correct  the  value. 

INVALID  DB2  SYSTEM  ID 


Reason:  The  DB2  system  lD  in  the  DSK2PARM  initialization  parameter  is 
invalid. 

Action:  Correct  the  value. 


OAM  REQUEST  FAILED,  RC=xx,  REASONsX’xxxxxxxx’ 

DB2  REQUEST  FAILED,  RC=X>C  REASON=X'xxxxxxxx' 

Reason:  The  OAM  or  DB2  request  failed  with  the  specified  return  and  reason 
codes. 

Action:  Consult  ihe  Object  Access  Method  Application  Programmer's  Reference  for  a 
list  of  reason  and  return  codes. 

:  \ 

NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  The  optical  disk  device  cannot  be  accessed  directly  from  VM/CMS. 

Action:  Use  the  L  selection  code  to  submit  a  batch  job  to  temporarily  load  the 
SYSOUT  group  to  primary  disk  so  it  can  be  accessed. 


END  OF  DATA 

Reason:  An  imexpected  end  of  data  condition  was  encountered  when  accessing 
the  SYSOUT  group  on  secondary  disk  storage. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


SYSOUT  GROUP  IS  NOT  ON  SECONDARY  DISK  STORAGE 

Reason:  The  SYSOUT  group  is  identified  in  the  master  index  as  residing  on 
secondary  disk  storage,  but  it  could  not  be  found  there. 
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SARD0513 


SARD2M01 


SARD2M02 


SARD2M03 


SARD2M04 


Action:  Delete  the  disk  copy  of  the  SYSOUT  group  to  enable  the  tape  copy  to  be 
accessed. 

LOGICAL  ERROR  PROCESSING  DSH=ob}ect-name 

Reason:  The  internal  format  of  the  archived  SYSOUT  group  is  in  error  and 
cannot  be  used. 

Action:  Delete  and  re-archive  the  SYSOUT  group. 


NO  DATABASE  HIGH-LEVEL  INDEX  SPECIFIED 

Reason:  No  database  high  level  index  was  specified  in  the  SARDSK2B  batch  job 
for  optical  disk  migration. 

Action:  Rerun  the  job  with  the  appropriate  parameters. 


NO  PCR  RECORD  FOUND  IN  DATABASE 

Reason:  ERO  (Expanded  Retention  Option)  settings  are  not  specified  for  this 
database. 

Action:  Verify  that  you  have  implemented  the  Expanded  Retention  Option  for 
the  reports  in  the  database.  For  information,  see  Chapter  6,  "Expanded  Retention 
Option." 


DSK2DRVR  MUST  BE  SPECIFIED  WITH  SARINIT 

Reason:  No  DSK2DRVR  parameter  was  specified  in  the  SARINIT  job. 

Action:  Specify  the  appropriate  DSK2DRVR  parameter  for  the  optical  device  you 
are  using. 


ERROR  LOADING  DSK2DRVR 

Reason:  An  error  occurred  loading  the  secondary  disk  driver. 


Action:  Verify  that  the  DSK2DRVR  ERO  initialization  parameter  is  appropriately 
specified  (00, 01, 02,  etc.). 
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SARD2M05 


SARD2M06 


SARD2M07 


SARD2M51 


SARD2M63 


SARD2M97 


ERROR  INITIALIZING  DSK2DRVR 

Reason;  An  error  occurred  initializing  the  secondary  (optical)  disk  driver. 

Action;  Verify  that  all  components  of  your  optical  system,  including  hardware, 
OAM  (if  it  is  ijsed)  etc.,  are  properly  working.  If  the  problem  persists,  contact 
Computer  Associates  Technical  Support. 


ERROR  INITIALIZING  SARPAR 

Reason:  An  error  occurred  irutializing  ERO  (Expanded  Retention  Option). 

Action:  Verify  that  the  SARPATAB  DD  statement  is  specified  in  your  CA-View 
started  task  JCL  (SARSTC),  and  that  the  correct  name  of  the  table  is  specified. 


ERROR  FINALIZING  SARPAR 

Reason:  An  error  occurred  finalizing  ERG  (Expanded  Retention  Option). 

Action:  Verify  that  your  ERG  table  is  valid.  If  the  problem  persists,  contact 
Computer  Associates  Technical  Support. 


SYSOUT  GROUP  NOT  DELETED  DUE  TO  PREVIOUS  I/O  ERROR 

Reason;  The  SYSOUT  group  was  not  deleted  from  secondary  disk  due  to  an  I/O 
error. 


Action;  Refer  to  the  discussion  and  action  for  the  previously  issued  I/O  error 
message. 


OPTICAL  MIGRATION  READING  GCR  FOR:  reporf-id,  GEN  nnnn 

Reason;  This  informational  message  us  issued  every  10  minutes,  when  the 
optical  migration  subtask  is  reading  the  GCRs  (Group  Control  Records)  from  the 
disk  database. 

Action:  None.  This  is  an  informational  message. 


OPTICAL  MIGRATION  ENDED  DUE  TO  BACKUP 

Reason:  The  backup  cycle  began  running,  so  the  optical  migration  subtask 
stopped. 
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Action:  None.  This  is  an  informational  message. 


SARD2M98  OPTICAL  MIGRATION  ENDED  DUE  TO  DSK2MIGD 

Reason:  The  ERO  initialization  parameter  DSK2MIGD  parameter  had  an  N 
specified  (no  migration),  so  optical  migration  has  ended. 

Action:  None.  This  is  an  informational  message. 

SARD2M99  OPTICAL  MIGRATION  ENDED  SCHEDULED  TIME  RANGE 

Reason:  This  message  is  informational. 

Action:  None. 


SARDBAO 1  DATASET  SUCCESSFULLY  ADDED  TO  DATABASE 

dsname 
unit 
volser 
nnnnn 
nnnnn 
nnnnn 
mgmtclass 
storclass 
dataclass 

Reason;  The  requested  space  has  been  added  to  the  database.  Physical  attributes 
of  the  newly  added  data  set  are  provided.  Non-SMS  data  sets  are  shown  as 
having  a  management,  storage,  and  data  class  of  NON-SMS. 

Action:  None.  This  is  an  informational  message. 

SARDBA02  DATABASE  SUCCESSFULLY  RENAMED 


u 


DSNAME: 

UNIT  REQUESTED: 
VOLUME  SERIAL  NO.: 
CYLINDERS: 

BLOCKS: 

BLOCK  SIZE: 
MANAGEMENT  CLASS: 
STORAGE  CLASS: 

DATA  CLASS: 


Reason;  The  database  was  successfully  renamed. 
Action:  None.  This  is  an  informational  message. 


SARDBA03  DATABASE  SUCCESSFULLY  DELETED 


Reason:  The  database  was  successfully  deleted. 
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SARDBA04 


SARDBA05 


SARDBA06 


SARDBA07 


SARDBA08 


Action:  None.  This  is  an  inf onnational  message. 

INVALID  CONTROL  STATEMENT  OPERATION 

Reason:  The  control  statement  has  an  invalid  operator. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 

INVALID  OR  MISSING  HIGH-LEVEL  INDEX  NAME 

Reason:  The  high-level  index  name  is  missing  or  invalid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 

INVALID  VOLUME  SERIAL  NUMBER 

Reason:  The  volume  serial  number  is  invalid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 

INVALID  OR  MISSING  CYLINDER  SPECIFICATION 

Reason:  The  number  of  cylinders  specification  is  invalid  or  missing. 
Action:  Correct  the  control  statement,  then  resubmit  the  job. 

INVALID  UNIT  NAME 

Reason:  The  rmit  name  is  missing  or  invalid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 
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SARDBA09 


This  message  number  represents  one  of  the  following  messages: 


STATUS  OF  DATABASE  high-level-name 
BLOCK  SIZE: 

TOTAL  BLOCKS: 

TOTAL  USED  BLOCKS: 

PERCENT  UTILIZATION: 

INDEX  STATISTICS: 

INDEX  LEVELS: 

INDEX  RECORDS: 

INDEX  ALLOCATIONS: 

INDEX  BLOCKS: 

INDEX  USED  BLOCKS: 

INDEX  POINTER  BLOCKS: 


nnnnnnnn 

nnnnnnnn 

nnnnnnnn 

nnnnnnnn 


INDEX  DATA  BLOCKS: 
INDEX  EMPTY  BLOCKS: 
DATASET  dsname 
CYLINDERS: 

BLOCKS: 

USED  BLOCKS: 

ERROR  BLOCKS: 


nnnnnnnn 

nnnnnnnn 

nnnnnnnn 

nnnnnn 


One  of  the  following  messages  may  be  issued  if  a  lock  file  has  been  created  for 
the  database: 

SARDBA09  NO  LOCK  CURRENTLY  HELD  ON  DATABASE 
SARDBA09  LOCK  HELD  BY  name  ON  mm/dd/yy  AT  hh:mm:ss 

Reason;  A  request  for  the  status  of  the  database  was  made  with  the  SARDBASE 
STATUS  command.  Statistics  on  the  database  are  presented.  Depending  on  the 
options  specified,  statistks  on  the  index  are  also  presented.  See  STATUS  in 
Chapter  7,  "Database  Utilities,"  for  more  mformation  about  tire  STATUS  control 
statement,  and  the  SARDBA09  index  statistics. 

Action:  None. 


SARDBAl  0  DATABASE  SUCCESSFULLY  COPIED 

Reason:  The  database  was  successfully  copied. 
Action:  None.  This  is  an  informational  message. 
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SARDBA11 


SARDBA12 


SARDBA13 


SARDBA14 


SARDBA15 


SARDBA16 


SARDBA17 


INDEX  FILE  SUCCESSFULLY  OUTPUT 

Reason:  The  master  index  was  successfully  written  to  the  sequential  output  file. 
Action:  None.  This  is  an  informational  message. 

ONLINE  LIBRARY  MEMBERS  SUCCESSFULLY  LOADED 

Reason:  The  online  library  members  were  successfully  loaded  to  the  database. 
Action:  None.  This  is  an  informational  message. 

INVALID  OPERAND  operand 

Reason:  The  specified  operand  is  invalid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 

INVALID  RELATIVE  GENERATION  NUMBER 

Reason:  The  relative  generation  number  specified  is  invalid  or  a  backup  of  the 
relative  generation  does  not  exist. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 

AUTHORIZATION  FAILED 

Reason:  The  user  is  not  authorized  to  perform  the  requested  function. 

Action:  Contact  the  appropriate  persormel  to  obtain  authorization  to  perform  the 
function. 


DATABASE  INDEX  SUCCESSFULLY  REORGANIZED 

Reason:  The  database  INDEX  was  successfully  reorganized. 
Action:  None.  This  is  an  informational  message. 

DATABASE  SUCCESSFULLY  RESTORED 

Reason:  The  database  was  successfully  restored. 
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SARDBA18 


SARDBA19 


SARDBA20 


SARDBA21 


SARDBA22 


SARDBA23 


Action:  None.  This  is  an  informational  message. 


DATABASE  SUCCESSFULLY  LOADED 

Reason:  The  database  was  successfully  loaded. 
Action:  None.  This  is  an  informational  message. 


DATABASE  SUCCESSFULLY  UNLOADED 

Reason:  The  database  was  successfully  unloaded. 
Action:  None.  This  is  an  informational  message. 


DATABASE  SUCCESSFULLY  VERIFIED 

Reason:  The  database  was  successfully  verified. 
Action:  None.  This  is  an  informational  message. 


VERIFICATION  TERMINATED  -  UNCORRECTABLE  ERROR 

Reason:  A  critical  error  as  indicated  by  previous  SARDBV  and/or  SARDVP 
messages  disallowed  successful  completion  of  the  verify  process. 

Action:  The  recovery  process  must  be  accomplished  by  using  the  RESTORE 
control  statement  of  the  SARDBASE  utility.  See  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  more  information. 


LOCK  DATASET  SUCCESSFULLY  CREATED 

Reason:  The  lock  data  set  was  successfully  allocated  and  formatted. 
Action:  None.  This  is  an  informational  message. 


LOCK  DATASET  SUCCESSFULLY  DELETED 

Reason:  The  lock  data  set  was  successfully  deleted. 
Action:  None.  This  is  an  informational  message. 
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SARDBA24 


SARDBA25 


SARDBA26 


SARDBA27 


SARDBA28 


SARDBA29 


NO  LOCK  CURRENTLY  HELD  ON  DATABASE 

Reasoni  The  unlock  function  of  the  SARDBASE  utility  attempted  to  release  a 
lock  held  on  the  lock  data  set  but  no  lock  existed. 

Action:  None.  This  is  an  informational  message. 


LOCK  HELD  BY  name  ON  mm/dd/yyAl  hh:mm:ss 
SUCCESSFULLY  RELEASED 

Reason:  The  lock  held  to  the  lock  data  set  was  xmsuccessfully  released. 
Action:  None.  This  is  an  informational  message. 


DATABASES  SUCCESSRJLLY  MERGED 

Reason:  The  databases  were  successfully  merged. 

Action:  None.  If  the  newly  merged  database  contains  backup  tapes  from  the 
merge  process,  run  the  SARPAG  utility  to  copy  the  SYSOUT  groups  on  tape  to 
new  tape  volumes  owned  by  this  database. 


INVALID  HIGH-LEVEL  INDEX  TAPE  INDEX 

Reason:  The  high-level  tape  index  name  indicated  on  the  MERGE  control 
statement  is  invalid.  The  tape  index  name  is  from  1  to  17  bytes  and  must  conform 
to  data  set  naming  conventicons. 

Action:  Correct  the  tape  index  name,  then  resubmit  the  job. 


INVALID  SECONDARY  DISK  DRIVER 

Reason:  There  is  a  syntax  error  in  the  secondary  disk  driver  specification  of  the 
MERGE  control  statement 

Action:  Verify  that  the  secondary  disk  driver  specification  is  the  same  as  the 
DSK2DRVR  initialization  parameter.  Check  to  see  that  it  is  the  name  of  an 
accessible  authorized  load  nwdule. 


INVALID  SECONDARY  DISK  PARAMETERS 

Reason:  There  is  a  syntax  error  in  the  secondary  disk  driver  parameters 
specification  of  the  hffiRGE  control  statement. 
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SARDBA30 


SARDBA31 


SARDBA32 


SARDBA33 


SARDBA34 


SARDBA35 


Action:  See  Chapter  10,  "Using  the  Optical  Disk  Interface,"  for  the  parameters 
required. 


NO  LOCK  DATASET  EXISTS 

Reason:  This  message  indicates  that  a  SARDBASE  UNLOCK  request  was 
entered,  however  the  database  does  not  have  an  associated  VM  lock  file. 

Action:  None.  This  is  an  informational  message. 


INVALID  BLOCKSIZE 

Reason:  The  block  size  :s  invalid. 

Action:  Correct  the  conmol  statement,  then  resubmit  the  job. 


INVALID  DATABASE  RELEASE  LEVEL 

Reason:  The  CA-View  programs  being  used  are  not  at  the  same  release  level  as 
what  is  specified  in  the  SARDBASE  control  statement. 

Action:  Verify  the  STEPLIB  or  link-listed  version  of  the  programs. 


RELEASE  SUCCESSFULLY  CONVERTED  TO  XXX 

Reason:  The  database  version  has  been  successfully  changed  with  the 
SARDBASE  VERSION  control  statement. 

Action:  None.  This  is  an  informational  message. 


STATISTICS  SUCCESSFULLY  CALCULATED 

Reason:  Database  statistics  were  successfully  calculated  using  the  SARDBASE 
STATUS  control  statement. 

Action:  None.  This  is  an  informational  message. 


UNKNOWN  KEYWORD  xxxxxxxx 

Reason:  The  keyword  specified  in  the  ADDDS  control  statement  specifications 
was  not  a  valid  ADDDS  keyword. 
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SARDBA36 


SARDBA37 


SARDBA38 


SARDBA39 


SARDBA40 


Action:  Correct  the  control  statement,  then  resubmit  the  job. 


INVALID  PARAMETER  SPECIFICATION 


Reason:  The  appropriate  syntax  of  keyword=value  was  not  used  in  the  ADDDS 
control  statement  specifications. 

Action:  Correct  the  control  statements  to  follow  the  ke5rword=value  syntax,  then 
resubmit  the  job. 


INVALID  DATA  CLASS  NAME 

Reason:  The  SMS  data  class  specified  in  the  ADDDS  control  statement 
specifications  was  not  valid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 


INVALID  MANAGEMENT  CLASS  NAME 

Reason:  The  SMS  management  class  specified  in  the  ADDDS  control  statement 
specifications  was  not  valid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 


INVALID  STORAGE  CLASS  NAME 

Reason:  The  SMS  storage  class  specified  in  the  ADDDS  control  statement 
specifications  was  not  valid. 

Action:  Correct  the  control  statement,  then  resubmit  the  job. 


INCORRECT  GENLEVEL  FOR  CAIRIM  -  GENLEVEL  9111  OR 
HIGHER  REQUIRED  FOR  LMP 

Reason:  CA-View  requires  a  GENLEVEL  level  of  9512  or  higher  for  CA90s  to 
perform  licensing  authentication. 

Action:  Install  a  more  current  version  of  CA90s. 
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SARDBA91 


SARDBC01 


SARDBC02 


SARDBC03 


SARDBC04 


PROCESSING  TERMINATED  DUE  TO  STOP  COMMAND 

Reason:  A  stop  command  was  issued  for  the  SARDBASE  utility.  Control 
statement  processing  was  prematurely  ended. 

Action:  None. 


INVALID  COMMAND  command 

Reason:  The  MVS  operator  command  issued  to  the  SARDBASE  utility  is  in¥alid 
or  not  supported. 

Action:  See  Chapter  7,  "Database  Utilities,"  for  the  syntax  of  the  operator 
commands  for  the  SARDBASE  utility  and  reissue  the  MVS  operator  command. 


ERROR  ON  “FROM”  DATABASE 

Reason:  An  I/O  error  occurred  reading  the  SYSOUT  to  be  copied.  The  SYSOUT 
is  skipped  and  execution  continues  with  the  next  SYSOUT  group. 

Action:  See  the  associated  message  for  the  I/O  error. 


ERROR  ON  “TO”  DATABASE 

Reason:  An  I/O  error  occurred  writing  the  SYSOUT  on  the  output  database. 
Execution  is  terminated. 

Action:  See  the  associated  message  for  the  I/O  error. 


SYSOUT  GROUP  IS  BEING  COPIED  -  ID=/c/,  GEN=:nnnnn, 
SEQ=nnr»nn 

Reason:  The  specified  SYSOUT  group  is  being  copied. 

Action:  None. 

INPUT  DATABASE  AT  INCORRECT  LEVEL 

Reason:  The  CA-View  database  used  as  input  for  SARDBASE  COPY  is  at  the 
incorrect  release  level; 

Action:  Verify  the  versions  of  the  TO  and  FROM  databases  for  the  SARDBASE 
COPY.  If  necessary,  change  the  versions  with  SARDBASE  VERSION. 


Diagnostic  and  Error  Messages  12-121 


Diagnostic  and  Error  Messages 


SARDBC05 


SARDBG01 


SARDBG02 


SARDBG04 


SARDBG05 


SYSOUT  INDEX  IS  BEING  COPIED  -  Mi^xxxxxxxxxxxx 
GEN=xxxxx,  SEQ=xxxxx 

Reason:  This  message  indicates  that  the  page  index  for  the  given  SYSOUT  group 
is  being  copied. 

Action:  None.  This  is  an  informational  message. 


ERROR  ON  DATABASE 

Reason:  There  has  been  an  error  in  the  processing  of  the  database.  There  is  an 
message  preceding  this  message  indicating  the  error  condition. 

Action:  Respond  to  the  preceding  error  message. 


DATABASE  IS  BEING  CONVERTED 

Reason:  A  REORG  during  database  conversion  is  in  process. 

Action:  None. 

ARCHIVAL  DATE  FORMAT  INVALID  FOR  \D=xxxxxxxxxxxx, 
RECORD  DROPPED 

Reason:  An  alternate  control  record  entry  could  not  be  added  to  the  alternate 
index  because  the  archival  date  for  the  specified  SYSOUT  was  invalid. 

Action:  None.  The  problem  may  be  the  result  of  a  database  corruption  or  a 
SARSTCUX  user  exit  that  was  coded  erroneously. 


REORGANIZING  xxxxxxxxxxxx,  GEN=nnnn,  ARCHIVED  ON 
mm/dd/yyAT  hh.mm 

Reason:  This  informational  message  is  a  progress  report  issued  during  a 
SARDBASE  KEORG.  It  will  appear  at  intervals  specified  by  the  SARINIT 
parameter  DBMSGFRQ>  whidi  only  cotmts  SYSOUT  IDs.  Therefore,  with  a 
default  DBMSGFRQ=5000,  this  message  will  appear  for  every  5000th  SYSOUT. 

Action:  None. 
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SARDBG07 


SARDBG08 


SARDBG09 


SARDBG10 


ALTERNATE  INDEX  REORGANIZATION  STARTED 

Reason:  This  informational  message  indicates  the  start  of  the  alternate  index 
record  reorganization  phase  of  an  asynchronous  SARDBASE  REORG.  The 
alternate  index  records  identify  the  starting  date  and  SYSOUT  IDs  of  a 
generation.  These  records  are  updated  reflect  current  SYSOUTs  and  reports  in 
the  database. 

Action:  None. 


INDEX  RECORD  REORGANIZATION  STARTED 

Reason:  This  message  indicates  the  start  of  the  index  record  reorganization 
phase  of  an  asynchronous  SARDBASE  REORG.  During  this  phase  of  the  REORG, 
the  database  index  structure  is  compressed  to  provide  optimal  access  time. 

Action:  None.  This  is  an  informational  message. 


REORG  PROCESSING  ALTERNATE  INDEX  GEN  gen  WITH  count 
GEN(S)  REMAINING 

Reason:  This  message  indicates  that  the  SARDBASE  utility  is  currently  in  the 
second  phase  of  the  asynchronous  REGRG.  This  message  is  issued  in  response  to 
the  status  operator  command. 

Action:  None.  This  is  an  informational  message. 


REORG  SUCCESSFULLY  TERMINATED  DUE  TO  STOP  COMMAND 

Reason:  A  stop  command  was  issued  during  processing  of  the  SARDBASE 
asynchronous  REORG.  Reorganization  processing  has  been  properly  terminated, 
leaving  aU  reorganization  activity  intact. 

Action:  None.  This  is  an  informational  message. 


REORG  CANCELLED  DUE  TO  STOP  COMMAND 

Reason:  A  stop  command  was  issued  during  processing  of  the  SARDBASE 
standard  REORG.  Reorganization  processing  was  terminated  and  the  database 
was  reset  to  the  pre-organization  state. 

Action:  None.  This  is  an  informational  message. 
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SARDBIOO 

through 

SARDBMS 


SARDBIOO  DATABASE  DOES  NOT  EXIST 
SARDBIOl  ALLOCATION  FAILED  -  ERROR=xxxx,  INFO=:XXXX 
SARDBI02  PHYSICAL  I/O  ERROR  -  ECB=xxxxxxxx 
SARDBI03  DATASET  NUMBER  OUT  OF  RANGE  -  DCCB=xxxxxxxx 
SARDBI04  DATASET  RENAME  FAILED  FOR  function 
SARDBI05  UNSUPPORTED  DEVICE  TYPE  -  BLKS/CYL=nnnn 
SARDBI06  MORE  THAN  127  DATASETS  -  NUMBERsnnnnn 
SARDBI07  NO  MORE  SPACE  IN  DATASET 
SARDBI08  MISSING  HIGH-LEVEL  INDEX  NAME  OF  DATABASE 
SARDBI09  LOGICAL  I/O  ERROR,  xxxKEY=X’yyyyyyyyyyyyyyyy’ 
SARDBI10  UNEXPECTED  END  OF  DATA, 
xx)0(Ey=yyyyyyyyyyyyyy’ 

SARDBI1 1  RECORD  NOT  FOUND,  xxxK£V=X’yyyyyyyyyyyyyyyy’ 
SARDBI12  LOCK  DATASET  ALREADY  EXISTS 
SARDBMS  LOCK  DATASET  DOES  NOT  EXIST 


Reason:  An  I/O  error  occurred  with  the  CA-View  database  as  described  by  the 
text  of  the  message  where: 


XXX  Specifies  the  control  block  being  processed  (SFB,  IFB,  or 

XFB) 

yyyyyyyyyyyyyyyy  Specifies  the  key  of  the  record  in  hex 

If  the  key  is  longer  than  16  bytes,  orJy  the  first  16  bytes  are 
shown. 


These  messages  may  also  have  the  following  appended  to  them: 

,  progrcua-name  IiOCATXOKf  n 

where: 

program-name  Specifies  the  name  of  a  CA-View  program  (such  as 

SARPAM) 

n  Specifies  a  number  identifying  the  location  in  the 

program  where  the  error  was  detected 

Action:  Correct  the  problem  with  the  database.  This  can  require  copying  the 
database  with  the  SARDBASE  utility  or,  in  the  extreme  case,  recovering  the 
database.  See  Chapter  7,  "Database  Utilities,"  and  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  information. 

For  information  about  the  error  codes  contained  in  the  SARDBIOl  message,  refer 
to  the  IBM  manual  GC28-1645,  AppHcah'on  Development  Guide:  Authorized 
Assembler  Language  Programs.  See  the  section  on  requesting  SVC99  functions. 
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SARDBilS 


SARDBI21 


DATACLAS/MGMTCLAS/STORCLAS  ALLOWED  ONLY  FOR  SMS 
DATA  SETS 

Reason:  In  the  ADDDS  statement  of  a  SAIUDBASE  job,  one  of  the  SMS 
parameters  (DATAGLAS/MGMTCLAS/STORCLAS)  was  specified,  but  the  data 
setCA-View  attempted  to  allocate  for  the  database  was  a  nomSMS  data  set. 

Action:  If  the  data  set  should  not  be  SMS-managed,  do  the  following: 

1.  Remove  the  SMS  parameters  from  the  ADDDS  statement. 

2.  Ensure  that  the  storage  class  is  not  defaulted  by  an  site-written  AGS  routine. 

3.  Resubmit  the  SARDBASE  job. 

If  the  data  set  should  be  SMS-managed,  specify  an  appropriate  STORGLAS,  or 
ensure  that  storage  class  is  selected  by  an  site-written  AGS  routine,  then  resubmit 
the  SARDBASE  job. 


UNIT/VOLSER  ALLOWED  ONLY  FOR  NON-SMS  DATA  SETS 

Reason:  In  the  ADDDS  statement  of  a  SARDBASE  job,  the  UNIT  or  VOLSER 
parameter  was  specified,  but  the  data  set  GA-View  attempted  to  allocate  for  the 
database  was  an  SMS  data  set. 

Action:  If  the  data  set  should  not  be  SMS-managed,  do  the  following: 

1.  Remove  any  SMS  parameters  from  the  ADDDS  statement. 

2.  Ensure  that  the  storage  class  is  not  selected  by  an  site-written  AGS  routine. 

3.  Resubmit  the  SARDBASE  job. 

If  the  data  set  should  be  SMS-managed,  remove  the  UNIT  and  VOLSER 
parameters  from  the  ADDDS  statement,  then  resubimt  the  SARDBASE  job. 


SUBFILE  ALLOCATION  I/O  ERROR  ON  DATASET  dsname  -  NEXT 
DATASET  USED 

Reason:  An  I/O  error  occurred  allocating  space  on  the  specified  data  set.  The 
allocation  will  be  attempted  on  the  next  data  set  in  the  database. 

Action:  Probably  none;  however,  verify  that  there  is  no  major  problem  with  the 
database. 
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SARDBI22 


SARDBI23 


SARDBI30 


SARDBL01 


SARDBL02 


I/O  ERROR  FOR  BLOCK  nnnnn  -  BLOCK  REMOVED  FROM 
DATABASE 


Reason:  An  I/O  error  occurred  writing  a  block  to  the  database.  The  block  is 
marked:  in  error  and  the  data  in  the  block  is  rewritten  to  a  different  location  in  the 
database. 

Action:  Probably  none;  however,  verify  that  there  is  no  major  problem  with  the 
database. 


database  DATABASE  IS  AT  nn%  UTILIZATION 

Reason:  The  database  has  exceeded  maximum  threshold  of  utilization;  the  actual 
percentage  used  is  given: 

Action:  None;  however,  the  database  should  be  monitored  to  see  that  it  does  not 
run  out  of  space.  It  may  be  r^ecessary  to  add  more  space  to  the  database.  The 
maximxun  threshold  setting  can  be  altered  by  changing  the  DBTHRESH 
initialization  parameter. 


This  message  niunber  represents  one  of  the  following  messages: 

JOB  jobname  (jobid)  WAITING  FOR  EXCLUSIVE  LOCK  ON  data¬ 
base 

LOCK  HELD  BY  name  ON  mm/dd/yyAl  hh:mm:ss 

Reason:  The  specified  job  could  not  obtain  an  exclusive  lock  on  the  lock  data  set 
to  update  data  in  the  specified  database.  The  message  will  be  issued  in  one 
minute  intervals  until  the  lock  is  resolved. 

Action:  If  the  lock  is  held  by  a  user  or  job  that  is  no  longer  executing  due  to  an 
abend  or  cancellation^  use  the  UNLOCK  control  statement  of  the  SARDBASE 
utility  to  release  the  lock.  Otherwise,  the  lock  will  be  obtained  when  available. 


MEMBER  xxxxxxxx  IS  BEING  LOADED  TO  DATABASE 

Reason:  The  specified  online  library  member  is  being  loaded  to  the  database. 
Action:  None.  This  is  an  informational  message. 


INPUT  DATASET  IS  EMPTY,  NOTHING  TO  LOAD 

Reason:  No  panels  were  found  in  the  input  OLIB  data  set. 
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SARDBL03 


SARDBM01 


SARDBM02 


SARDBM03 


SARDBN01 


Action:  Verify  that  your  CA-View  OLIB  data  set  is  correctly  named  in  the 
STEPLIB,  and  that  it  contains  panels. 


SAROLIB  DD  STATEMENT  MISSING 


Reason:  An  OLOAD  control  statement  was  issued  to  load  online  members  into 
the  CA-View  database,  but  the  SAROLIB  DD  statement  was  not  specified.  The 
SAROLIB  DD  statement  references  the  library  containing  the  online  members 
and  is  required  for  the  load  request. 

Action:  Add  the  SAROLIB  DD  statement  referencing  the  library  containing  the 
online  members,  then  resubmit  the  load  request. 


SECONDARY  DISK  ERROR  FOR  \D=:xxxxxxxx,  GEN=xxxxx, 
SEQsxxxxx 

Reason:  CA-View  cannot  write  to  the  secondary  disk. 

Action:  Verify  your  DSK2PARM  initialization  parameter. 


ERROR  ON  “TO”  DATABASE 

Reason:  There  is  an  error  on  the  database  being  copied  to. 

Action:  Verify  that  the  database  has  enough  allocation  (you  ihay  increase  the 
allocation  with  SARDBASE  ADDDS),  and  that  the  DASD  is  available  to  the 
system. 


UNEXPECTED  END  OF  DATA  ON  INPUT  FILE 

Reason:  CA-View  foimd  the  end  of  the  SARLOAD  file  before  the  database  was 
fully  loaded. 

Action:  Verify  that  the  SARLGAD  data  set  is  complete. 

SARMERG1  AND  SARMERG2  DD  STATEMENTS  MISSING 

Reason:  A  SARDBASE  MERGE  job  was  submitted  without  DD  statements. 
Action;  Include  the  DD  statements  in  the  SARDBASE  JCL. 
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SARDBN02 


SARDBN03 


SARDBN04 


SARDBN05 


SARDBN06 


SARDBN07 


UNEXPECTED  END  OF  DATA  ON  INPUT  TAPE 

Reason:  One  of  the  SAMDBASE  MERGE  input  tapes  is  incomplete. 

Action:  Verify  that  all  SARDBASE  MERGE  input  tapes  are  correct,  and  rerun 
SARDBASE  MERGE. 


NOTHING  ARCHIVED  -  MERGE  TERMINATED 

Reason:  The  MERGE  input  tapes  do  not  contain  any  data. 

Action:  Verify  that  all  SARDBASE  MERGE  input  tapes  are  correct,  and  renon 
SARDBASE  MERGE. 

LOAD  FAILED  -  MERGE  TERMINATED 

Reason:  One  of  the  input  tapes  for  SARDBASE  MERGE  failed  to  load  to  the 
database. 

Action:  Verify  that  aU  SARDBASE  MERGE  input  tapes  were  created  by  the 
SARDBASE  UNLOAD  facOity. 


PHASE  1  SCAN  FOR  SARMERGx 

Reason:  Input  tape  SARMERGa:  began  scan  processing. 

Action:  None. 

LOAD  INVOKED  FOR  SARMERGx 

Reason:  Input  tape  SARMERGx  began  load  processing. 

Action:  None. 

MAXIMUM  SYSOUT  SEQUENCE  NUMBER  EXCEEDED  FOR  NEW 
GENERATION  nnnnnnnn 

Reason:  In  the  SARDBASE  MERGE  operation,  a  new  generation  nnnnnnnn 
exceeded  64,000  SYSOUTs. 

Action:  Reduce  the  number  of  input  databases  and  renm  SARDBASE  MERGE. 
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SARDBN08 


SARDBN09 


SARDBN10 


SARDBN12 


SARDBN13 


CONFLICT  EXISTS  WITH  NEW  TAPE  HIGH-LEVEL  INDEX 

Reason:  The  tape  index  for  the  output  database  is  the  same  as  one  of  the 
SARDBASE  MERGE  input  tapes. 

Action:  Name  the  output  tape  index  differently  than  any  of  the  MERGE  input 
tapes,  and  rerun  SARDBASE  MERGE. 


SECONDARY  DISK  FILES  WERE  NOT  UNLOADED 

Reason:  One  or  more  of  the  SARMERGX  tapes  containing  data  on  optical  disk 
was  not  properly  UNLOADed  with  the  SECOND/NOSECOND  parameter  of  the 
SARDBASE  MERGE  facility. 

Action:  Unload  all  databases  with  the  SECOND/NOSECOND  parameter  of 
SARDBASE  UNLOAD  specified.  Then  rerun  SARDBASE  MERGE. 


UNLOADED  SECONDARY  SYSOUT  GROUPS  BEING  LOADED  TO 
PRIMARY  DATABASE 

Reason:  SYSOUTS  are  being  loaded  to  disk  by  SARDBASE  MERGE.  The 
SYSOUTs  were  on  optical  disk,  and  were  unloaded  to  tape  by  SARDBASE 
UNLOAD,  with  the  SECOND  parameter  specified. 

Action:  None.  This  is  an  informationai  message. 


LOAD  FAILED  FOR  SECONDARY  DISK  DRIVER 

Reason:  The  secondary  disk  storage  driver  specified  in  the  MERGE  control 
statement  of  SARDBASE  could  not  be  successfully  loaded  for  execution. 

Action:  Correct  the  control  statement,  and  rerun  SARDBASE  MERGE. 


NO  MCR  RECORD  FOUND 

Reason:  One  of  the  SARDBASE  MERGE  input  tapes  is  missing  the  Master 
Control  Record. 

Action:  Check  the  output  of  all  SARDBASE  UNLOAD  jobs,  that  were  used  to 
create  input  tapes  for  SARDBASE  MERGE.  Verify  that  complete  tapes  were 
created.  Rerun  SARDBASE  MERGE. 
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SARDBP01 


SARDBR01 


SARDBR02 


SARDBR03 


SARDBR04 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP.  W 

INVALID  bik 


Reason;  A  CA-View  program  has  terminated,  and  a  diimp  was  generated.  In  this 
message,,fcZfc  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  EFB,  SFB,  XFB,  or  DBB).  It  may  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program  detected  the  problem. 

Action:  Send  the  dump  to  Computer  Associates  Technical  Support.  Restart 
whatever  program  was  terminated.  If  the  problem  recurs,  run  SARDBASE 
VERIFY  on  the  database.  Ifi  the  problem  persists,  contact  Computer  Associates 
Technical  Support. 


ERROR  ON  “FROM”  DATABASE 

Reason:  An  I/O  error  occurred  reading  the  SYSOUT  to  be  restored.  The 
SYSOUT  is  skipped  and  execution  continues  with  the  next  SYSOUT  group. 

Action:  See  the  associated  message  for  the  I/O  error. 


ERROR  ON  “TO”  DATABASE 

Reason:  An  I/O  error  occurred  writing  the  SYSOUT  on  the  output  database. 
Execution  is  tenninated. 

Action:  See  the  associated  message  for  the  I/O  error. 


AHEMPT  TO  COPY  SYSOUT  GROUP  FROM  OLD  DATABASE  - 
ID=/cf,  GEN=nnnnn,  SEQ=nnnnn 

Reason:  The  specified  SYSOUT  group  is  being  copied. 

Action;  None.  This  is  an  informational  message. 

REQUESTED  TAPE  FILE  DOES  NOT  CONTAIN  INDEX  BACKUP 

Reason;  The  file  recorded  in  the  backup  recovery  file  or  specified  in  the  JCL  does 
not  contain  a  backup  of  the  master  index. 

Action:  Use  SARTCP  to  map  the  backup  tape  to  locate  the  backup  of  the  master 
index. 
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SARDBR12 


SARDBR13 


SARDBR14 


SARDBR16 


SARDBR17 


AHEMPT  TO  COPY  ONLINE  MEMBER  FROM  OLD  DATABASE  - 
NAME=xxxxxxxx 

Reason:  The  specified  member  of  the  online  library  is  being  copied. 

Action:  None.  This  is  an  informational  message. 

PERMANENT  I/O  ERROR  READING  TAPE 

Reason:  A  permanent  1/ O  error  occurs  while  reading  the  tape  backup  of  the 
master  index. 

Action:  Resubmit  the  job.  If  the  error  recurs,  use  a  different  backup  for  restoring 
the  master  index. 

REQUESTED  BACKUP  DOES  NOT  EXIST 

Reason:  The  requested  backup  for  the  master  index  cannot  be  located. 

Action:  Restore  the  master  index  from  a  newer  backup. 

TAPE  ALLOCATION  ERROR  CODE  -  xxxx,  INFO  CODE  -  xxxx 

Reason:  Dynamic  allocation  failed  for  the  backup  tape  file.  The  hexadecimal 
error  and  information  codes  are  provided. 

Action:  Correct  the  problem,  then  resubmit  the  job. 

RESTORE  OF  DATABASE  BEGUN 

Reason:  The  restore  function  has  begim. 

Action:  None.  This  is  an  informational  message. 


PARTIAL  RESTORE  COMPLETED  -  ARCHIVAL  AND  ONLINE 
ACTIVITY  MAY  BE  RESUMED  FOR  high-level-prefix 

Reason:  Informational  message  indicating  that  the  restore  process  has  restored 
the  index  data  necessary  to  resume  archival  and  online  activity.  The  restore 
process  continues  with  the  restoration  of  SYSOUT  groups  and  SYSOUT  data. 
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SARDBR18 


SARDBR19 


SARDBR20 


SARDBR21 


SARDBR22 


Action:  If  errors  occurred  during  the  loading  of  panel  data  or  if  the  FROM 
database  was  omitted  from  the  RESTORE  control  statement,  online  panels  wiU 
have  to  be  reloaded  to  the  database  before  online  activity  can  be  resumed. 


LOADING  OF  SUBFILE  DATA-BEGUN 

Reason:  Informational  message  indicating  that  the  restore  process  will  proceed 
with  the  restoration  of  SYSOUT  groups  and  SYSOUT  data. 

Action:  None.  This  is  an  informational  message. 


PROCESSING  SUCCESSFULLY  COMPLETED 

Reason:  This  message  indicates  that  the  restore  process  has  completed. 
Action:  None.  This  is  an  informational  message. 


SYSOUT  GROUP  ADDS)  TO  INDEX  -  \D-xxxxxxxxxxxx, 
GENsxxxxx,  SEQsxxxxx 

Reason:  This  message  indicates  that  the  SYSOUT  groups  that  were  added  to  the 
database  during  the  restore  process.  This  message  is  also  written  to  the  operator 
console  at  intervals  based  on  the  DBMSGFRQ  initialization  parameter  to  inform 
the  operator  of  the  progress  of  the  restore  process. 

Action:  None.  This  is  an  informational  message. 


NEITHER  SARRECV  NOR  SARTAPE  DD  STATEMENTS  SUPPLIED  FOR 
RESTORE 

Reason:  A  SARTAPE  DD  statement,  or  a  SARRECV  DD  statement  has  not  been 
included  in  the  JCL  for  the  job.  CA-View  cannot  determine  the  backup  tape  to 
use  for  the  restore. 


Action:  Correct  the  JCL,  then  resubmit  the  job. 


MASTER  INDEX  IS  NOT  COMPLETE  ON  BACKUP  TAPE  SUPPLIED 

Reason:  The  master  index  must  be  contained  on  a  single  tape  volume  when  the 
SARRECV  DD  statement  is  not  specified. 


Action:  Correct  tape  sequence  and  retry. 
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SARDBR23 


SARDBR24 


SARDBR25 


SARDBR26 


SARDBT01 


RECOVERY  DATASET  ERROR  OPER=xxxx 

Reason:  Error  attempting  to  access  the  recovery  data  set 

Action:  None.  If  a  hardware  error  is  not  indicated.  Contact  Computer  Associates 
Technical  Support 


MULTI-VOLUME  MASTER  INDEX  IS  INVALID 

Reason:  The  first  record  on  this  tape  must  be  an  index  continuation  record.  This 
tape  may  have  been  used  out  of  sequence. 

Action:  Correct  tape  sequence  and  retry. 


VIEW  xxxxxxxxxxxx  ID  #n  IS  TOO  LONG.  VIEW  HAS 
BEEN  DROPPED 

Reason:  The  restore  process  attempted  conversion  of  an  old  view  record,  but  the 
view  record,  after  conversion,  is  too  long  and  it  cannot  be  restored.  The  indicated 
view  record  wiU  be  dropped. 

Action:  The  old  view  record  in  question  must  be  manually  added  to  the 
database. 


PANEL  AND  SYSOUT  DATA  NOT  RESTORED,  USE 
SARDBASE/OLOAD,  SARRSP,  AND/OR  SARTDR  UTILITIES  TO 
RESTORE 

Reason:  The  panel  and  SYSOUT  data  was  not  restored  because  an  old  database 
name  was  not  specified  in  the  RESTORE  control  statement. 

Action:  The  SARDBASE,  SARRSP,  and/ or  SARTDR  utilities  must  be  used  to 
restore  or  load  panel  or  SYSOUT  data  to  the  database. 


ERROR  ON  DATABASE 

Reason:  An  I/O  error  occurred  when  opening  the  database. 

Action:  Probably  none;  however,  verify  that  there  is  no  major  problem  with  the 
database. 
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SARDBT02 


SARDBT03 


SARDBT04 


SARDBT05 


SARDBT06 


SARDBU01 


DATABASE  ALREADY  AT  THE  DESIRED  LEVEL 

Reason:  The  database  is  already  at  the  desired  level. 

Action:  None.  This  is  an  informational  message. 

UNSUPPORTED  DATABASE  LEVEL 

Reason:  The  release  level  to  be  converted  to  is  not  supported. 

Action:  Check  the  release  number,  then  resubmit  the  job. 

DATABASE  RELEASE  LEVEL  SUCCESSFULLY  CONVERTED  TO  xxx 

Reason:  The  specified  release  is  being  converted. 

Action:  None.  This  is  an  informational  message. 

INPUT  UNin=xxxxxxxx,  OUTPUT  miU^xxxxxxxx 

Reason:  The  unit  name  of  tape  data  set  specified  in  INPUT  UNITT  is  different 
than  that  of  duplex  tape  data  set  specified  in  OUTPUT  UNITT. 

Action:  None.  This  is  an  informationalmessage. 


DUPLEX  TAPE  UNIT  RESET  TO  BE  IDENTICAL  TO  PRIMARY  TAPE 
UNIT 

Reason:  The  imit  name  of  duplex  tape  data  set  is  being  converted  to  the  same 
unit  name  as  tape  data  set. 

Action:  None.  This  is  an  informational  message. 


ERROR  ON  “FROM”  DATABASE 

Reason:  An  I/O  error  occurred  reading  the  SYSOUT  to  be  written  to  tape.  The 
SYSOUT  is  skipped  and  execution  continues  with  the  next  SYSOUT  group. 

Action:  See  the  associated  message  for  the  I/O  error. 
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SARDBU03 


SARDBU04 
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This  message  number  represents  one  of  the  following  messages: 

SECONDARY  DISK  ERROR  FOR  ID=xxxxxxxx,  GEN=xxxxx, 
SEQsxxxxx 

SECONDARY  DISK  ERROR  FOR  RESOURCE=:xxxxxxxxxxx 

Reason:  CA^View  cannot  write  to  secondary  disk. 

Action:  Verify  your  E6K2PARM  irutialization  parameter. 


UNABLE  TO  LOAD  SECONDARY  DISK  STORAGE  DRIVER 

Reason:  CA-View  cannot  find  the  program  required  to  access  secondary  storage. 
Action:  Determine  if  the  program  is  available  in  STEPLIB  or  link-list. 


ERROR  ON  GET  E€RJAL  FOR  IDsxxxxxxxxxxxx  GENsxxxxx, 
SEQ=xxxxx 

Reason:  The  given  SYSGUT  group  was  being  unloaded  from  secondary  disk  to 
the  unload  file,  but  the  SYSOUT  group  is  no  longer  in  the  CA-View  database. 

Action:  None.  The  SYSOUT  group  will  not  be  imloaded,  and  the  unload 
continues  processing  with  the  next  SYSOUT  group. 


INDEX  BLOCK  VERIFICATION  STARTED 

Reason:  Informational  message  indicating  the  start  of  the  index  file  block 
mapping  phase  of  the  database  verification  process.  The  verification  process 
involves  three  phases  which  are  the  index  file  block  mapping  phase,  the  index 
record  verification  and  subfile  (SYSOUT  data  and  panel  data)  mapping  phase, 
and  the  alternate  index  and  extended  index  record  verification  phase. 

Action:  None.  This  is  an  informational  message. 


INDEX  RECORD/SUB-FILE  DATA  VERIFICATION  STARTED 

Reason:  Informational  message  indicating  the  start  of  the  index  record 
verification  and  subfile  (SYSOUT  data  and  panel  data)  mapping  phase  of  the 
database  verification  process.  The  verification  process  involves  three  phases 
which  are  the  index  file  block  mapping  phase,  the  index  record  verification  and 
subfile  mapping  phase,  and  the  alternate  index  and  extended  index  record 
verification  phase. 
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SARDBVl  3 


SARDBVl  4 


Action:  None.  This  is  an  informational  message. 


INDEX  VERIFICATION  FOR  ID=:/cf,  GEN=gen,  SEQ=sec7 

Reason:  Informational  message  indicating  the  index  record  currently  being 
processed  in  index  record  verification  and  subfile  mapping  phase.  Tiiis  message 
is  written  to  the  operator  console  on  an  interim  basis  depending  on  the  frequency 
defined  in  the  DBMSGFRQ  initialization  option. 

Action:  None.  This  is  an  informational  message. 


ALTERNATE  INDEX  FROM  INCOMPLETE  REORG  DELETED 

Reason:  The  data  space  occupied  by  the  incomplete  REORG  function  is  freed 
from  the  database. 

Action:  None.  This  is  an  informational  message. 


SUB-FILE  VERIFICATION  FOR  ONLINE  MEMBER  xxxxxxxx 

Reason:  The  data  space  occupied  by  the  specified  online  member  (panel; 
message,  or  skeleton  JGL)  is  being  verified  and  mapped.  If  the  internal  structure 
of  the  subfile  is  incorrect,  the  online  member  may  be  truncated  or  lost. 

Action:  None.  This  is  an  informational  message. 


This  number  represents  one  of  tihe  following  messages: 

SUB-FILE  VERIFICATION  FOR  SYSOUT  MEMBER  xxxxxxxxxxxx 
SUB-FILE  VERIFICATION  FOR  RESOURCE  MEMBER  xxxxxxxxxxx 

Reason:  The  data  space  occupied  by  the  subfile  for  the  specified  SYSOUT  or 
page  layout  RESOURCE  is  being  verified  and  mapped.  If  the  internal  structure  of 
the  subfile  is  incorrect,  the  archival  SYSOUT  data  may  be  truncated  or  lost. 

Action::  None.  This  is  an  informational  message. 
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SARDBV15 


SARDBV16 


SARDBV17 


This  number  represents  one  of  the  following  messages: 

AUXILIARY  FILE  VERIFICATION  FOR  SYSOUT  MEMBER 
xxxxxxxxxxxx 

AUXILIARY  FILE  VERIFICATION  FOR  RESOURCE  MEMBER 
xxxxxxxxxxx 

Reason:  The  data  space  occupied  by  the  auxiliary  file  (SYSOUT  indexing 
mapping  data)  for  the  specified  SYSOUT  or  page  layout  RESOURCE  is  being 
verified  and  mapped.  If  the  internal  structure  of  the  subfile  is  incorrect,  the 
auxiliary  data  may  be  truncated  or  lost. 

Action:  None.  This  is  an  informational  message. 


DUMMY  MCR  RECORD  IS  BEING  CREATED 

Reason:  A  master  control  record  (index  record  which  contains  initialization 
parameters  and  other  vital  information)  cannot  be  found  in  the  database  and  is 
being  created. 

Action:  After  the  database  verification  process  is  complete,  nm  the  SARINIT 
utility  to  reinstate  all  initialization  options. 


GENERATION  AND  TAPE  NUMBERS  RESET  IN  MCR 

Reason:  SYSOUT  groups  are  foimd  in  the  database  to  contain  a  higher 
generation  number,  sequence  number,  and/ or  tape  sequence  number  than 
indicated  in  the  master  control  record  (index  record  which  contains  initialization 
parameters  and  other  vital  information).  The  higher  generation  number,  sequence 
number,  and/ or  tape  sequence  number  are  being  placed  in  the  master  control 
record. 
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SARDBV21 


SARDBV22 


Action:  None.  This  is  an  informational  message. 


GENERATiON/SEQUENCE  NUMBERS  COMPLEMENTED  FOR 
MASTER  CONTROL  RECORD 

Reason:  The  current  generation  number  and  sequence  number  in  the  master 
control  record  are  being  changed  from  a  complemented  form  to  a  non- 
complemented  formi 

Action:  None.  This  is  an  informational  message. 


ALTERNATE  INDEX/EXTINDED  RECORD  VERIFICATION  STARTED 

Reason:  Informational  message  indicating  the  start  of  the  alternate  index  and 
extended  index  record  verification  phase  of  the  database  verification  process.  The 
verification  process  involves  three  phases,  as  follows: 

■  The  index  file  block  mapping  phase 

■  The  index  record  verification  and  subfile  (SYSOUT  data  and  panel  data) 
mapping  phase 

■  The  alternate  index  and  extended  index  record  verification  phase 
Action:  None.  This  is  an  informational  message. 


ALTERNATE  INDEX  VERIFICATION  FOR  ID=/d,  GEN=gen, 
SEQsseq 

Reason:  Informational  message  indicating  the  index  record  that  is  currently 
being  processed  in  the  alternate  index  and  extended  index  record  verification 
phase.  This  message  is  written  to  the  operator  console  on  an  interim  basis 
depending  on  the  frequency  defined  in  the  DBMSGFRQ  initialization  option. 

Action:  None.  This  is  an  informational  message. 


INVALID  EXTENDED  INDEX  RECORD  X’ record-key  DELETED 

Reason:  The  extended  index  record  for  the  specified  key  contains  invalid  data 
and  has  been  deleted  from  the  database. 

Action:  None.  This  is  an  informational  message. 
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SARDRP02 


INVALID  GROUP  CONTROL  RECORD  ID=/d,  GEN=gen,  SEQ=seq 
DELETED 

Reason;  The  index  record  for  the  specified  SYSOUT  group  contains  invalid  data 
and  has  been  deleted  from  the  database. 

Action:  None.  This  is  an  informational  message. 

DATABASE  VERIFICATION  COMPLETED 

Reason:  Informational  message  indicates  the  end  of  the  verification  process. 
Action:  None.  This  is  an  informational  message. 


FORWARD  RECOVERY  CAPTURE  ACTIVATED  FOR  dataset 

Reason:  The  SARSTG  archival  task  has  been  started  with  Forward  Recovery 
activated.  The  CA-View  iinitialization  parameters  RGVPRIM=xxr3:  and 
RCVUNIT=nnnn  activate  Forward  Recovery. 

Action:  None.  This  is  ani  informational  message. 


ALLOCATION  FAILED  FOR  dataset  -  ERROR=xxxx,  INFO=xxxx 

Reason:  An  error  occurred  during  the  allocation  of  a  forward  recovery  data  set. 
The  hexadecimal  error  and  information  codes  are  provided. 

Action:  The  allocation  error  message  may  not  be  critical  if  issued  during  the 
recovery  process  or  during  the  deletion  process  of  the  backup  cycle.  If  the 
message,  however,  is  issued  by  the  archival  task  during  archival  of  SYSOUT  data, 
forward  recovery  may  be  disabled  as  indicated  by  the  SARDRP99  message.  In 
this  case,  the  error  will  have  to  be  resolved  before  forward  recovery  can  be 
restarted.  Forward  recovery  can  be  restarted  by  recycling  the  archival  task  or  by 
initiating  a  backup  cycle. 


PHYSICAL  I/O  ERROR  ON  dataset-  £CB=xxxxxxxx 

Reason:  An  error  occurred  performing  I/O  to  a  forward  recovery  data  set. 
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SARDRP04 


SARDRP05 


Action:  If  the  I/O  error  occurred  while  recording  archival  data,  an  attempt  will 
be  made  to  recover  from  the  1/ O  error  by  allocating  a  new  forward  recovery  data 
set  and  writing  the  appropriate  information  to  the  new  data  set.  If  recovery  fails, 
forward  recovery  will  be  disabled  as  mdicated  by  the  SARDRP99  message.  In  this 
case,  the  error  will  have  to  be  resolved  before  forward  recovery  can  be  restarted. 
Forward  recovery  can  be  restarted  by  recycling  the  archival  task  or  by  initiating  a 
backup  cycle. 


UNRECOVERABLE  ERROR  ON  dataset 


Reason:  Forward  recovery  was  imable  to  recover  from  a  previous  error. 

Action:  See  the  explanation  and  action  indicated  by  the  previous  error  message 
for  resolution.  When  the  previous  error  is  resolved,  forward  recovery  may  be 
restarted  by  recycling  the  archival  task  or  by  initiating  a  backup  cycle. 


This  message  number  represents  one  of  the  following  messages: 

END  OF  FILE 

END  OF  FILE  READING  TAPE  CONTROL  RECORDS 
END  OF  FILE  READING  GROUP  CONTROL  RECORDS 
END  OF  FILE  READING  DATA  RECORDS 
END  OF  FILE  READING  AUXILIARY  RECORDS 
MASTER  CONTROL  RECORD  NOT  FOUND 
MASTER  CONTROL  RECORD  NOT  WRIHEN 
TAPE  CONTROL  RECORD  NOT  WRIHEN 
GCR  CONTROL  RECORD  NOT  WRIHEN 

DATASET  NOT  ALLOCATED  DUE  TO  INITIALIZATION  PARAMETERS 

Reason:  The  end-of-file  messages  are  purely  informational  and  rarely  issued. 
The  not  found/not  written  messages  may  indicate  possible  logic  errors.  These 
logic  errors  arise  when  there  are  no  forward  recovery  data  sets  to  read  from  or 
write  to.  The  data  set  not  allbcated  message  indicates  that  the  RCVUNIT  and/or 
RGVPRIM  initialization  parameters  were  not  initialized  to  activate  forward 
recovery. 

Action:  The  only  messages  that  may  require  attention  are  the  not  found  and  not 
written  messages.  Normally,  these  messages  will  be  accompanied  by  previous 
error  messages.  See  the  explanation  and  action  of  the  previous  error  messages  for 
resolution. 


OPEN  FAILED  FOR  dataset 

Reason:;  An  error  occurred  opening  a  forward  recovery  data  set. 
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SARDRP07 


SARDRP08 


SARDRP10 


Action:  Normally,  forward  recovery  will  continue  processing  by  allocating  a 
new  forward  recovery  data  set.  In  extreme  cases,  forward  recovery  may  be 
disabled  as  indicated  by  the  SA3^RP99  message.  In  this  case,  the  error  will  have 
to  be  resolved  before  forward  recovery  can  be  restarted.  Forward  recovery  can  be 
restarted  by  recycling  the  archival  task  or  by  initiating  a  backup  cycle. 


UNKNOWN  OR  INCONSISTENT  DATA  FORMAT  FOR  dataset 

Reason:  The  forward  recovery  data  set  does  not  conform  to  the  data  structure  of 
its  data  records.  This  condition  may  occur  when  foreign  data  is  copied  into  a 
forward  recovery  data  set  or  a  foreign  data  set  is  renamed  to  conflict  with  a 
current  forward  recovery  data  set.  This  message  may  also  be  produced  with  new 
releases  of  the  product  when  the  length  of  database  index  records  have  changed. 

Action:  None.  Forward  recovery  will  continue  processing  with  a  new  forward 
recovery  data  set. 


DEVICE  RESIDENCE  ERROR  FOR  dataset 

Reason:  The  residence  or  location  of  the  forward  recovery  data  set  on  a  DASD 
device  has  changed.  This  condition  may  occur  when  a  forward  recovery  data  set 
is  moved  to  a  different  volume  or  moved  to  a  different  location  within  the  same 
volume. 

Action:  None.  Forward  recovery  will  continue  processing  with  a  new  forward 
recovery  data  set. 


INSUFFICIENT  SPACE  ALLOCATION  FOR  dataset 

Reason:  The  space  allocation  for  the  forward  recovery  data  set  was  not  large 
enough  to  contains  its  internally  maintained  control  records  and  archival  control 
data. 


Action:  Increase  the  primary  and/or  secondary  space  allocation  amoimt  for  the 
forward  recovery  data  set  which  are  identified  by  the  RCVPRIM  and  RCVSEG 
initialization  parameters. 


INVALID  OR  OVERLAYED  CONTROL  BLOCK 

Reason:  The  internal  control  block  structure  used  to  control  the  forward 
recovery  data  sets  has  been  overlaid  or  destroyed. 
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Action:  This  error  may  occur  from  incorrectly  modified  user  exits  or  from 
internal  logic  errors.  Forward  recovery  will  be  disabled  as  indicated  by  the 
SARDRP99  message.  Forward  recovery  may  be  restarted  by  recycling  the 
archival  task  or  by  initiating  a  backup  cycle.  Contact  Computer  Associates 
Technical  Support  for  resolution. 


READ  FUNCTIONS  NOT  PERMIHED  DURING  OUTPUT  PROCESSING 
WRITE  FUNCTIONS  NOT  PERMIHED  DURING  INPUT  PROCESSING 

Reason:  I/O  activity  issued  against  a  forward  recovery  data  set  is  inconsistent 
with  its  designed  processing  features. 

Action:  This  error  identifies  a  flaw  in  the  internal  processing  logic.  Contact 
Computer  Associates  Technical  Support  for  resolution. 


WRITE  OF  GROUP  CONTROL  RECORD  REQUIRED  BEFORE 
WRITING  OF  RECORD  OR  AUXILIARY  DATA 

Reason:  I/O  requests  to  write  archived  data  or  auxiliary  data  to  the  forward 
recovery  data  set  were  not  preceded  by  an  I/O  request  to  write  the  archival 
group  control  which  identifies  the  archival  data. 

Action:  This  error  identifies  a  flaw  in  the  internal  processing  logic.  Contact 
Computer  Associates  Technical  Support  for  resolution. 


POSSIBLE  DATA  LOST  ON  dataset 

Reason:  Forward  recovery  was  imable  to  successfully  write  control  data  and/or 
archival  data  to  the  forward  recovery  data  set. 

Action:  This  error  is  normally  accompaiued  by  the  SARDRP12  I/O  error 
message.  Processing  will  normally  continue  with  a  new  forward  recovery  data 
set.  In  extreme  cases,  forward  recovery  will  be  disabled  as  indicated  by  the 
SARDRP99  message.  Forward  recovery  may  be  restarted  by  recycling  the 
archival  task  or  by  initiating  a  backup  cycle. 


DATASET  cfatose/ CREATED  ON  VOLUME  volume 

Reason:  This  message  indicates  that  a  forward  recovery  data  set  has  been 
allocated  on  the  specified  volume. 

Action:  None.  This  is  an  informational  message. 
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SARDRP99 


SARDVPOl 


SARDVP02 


SARDVP03 


DATASET  dotosef  DELETED 

Reason:  This  message  indicates  that  a  forward  recovery  data  set  has  been 
deleted.  Old  forward  recovery  data  sets  are  deleted  as  part  of  the  normal 
processing  flow  at  the  end  of  the  backup  cycle. 

Action:  None.  This  is  an  informational  message. 


FORWARD  RECOVERY  CAPTURE  DEACTIVATED  FOR  dataset 

Reason:  The  SARSTC  archival  task  has  stopped  the  process  of  capturing 
SYSOUT  and  writing  a  duplex  copy  of  it  to  the  forward  recovery  data  set.  This 
message  is  normal  during  shutdown  of  SARSTC. 

Action:  None  for  normal  shutdown.  Check  for  previous  error  messages 
indicating  I/O  errors  on  the  forward  recovery  data  set  if  this  message  occurs  at  a 
time  other  than normal  shutdown. 


INDEX  FILE  -  SPACE  ALLOCATION  VERIFICATION 

Reason:  The  index  file  space  allocation  is  being  verified. 
Action:  None.  This  is  ani  informational  message. 


***SPACE  ALLOCATION  CORRECTED 

Reason:  The  space  allocated  for  the  file  overlaps  that  of  another.  The  allocation 
has  been  corrected. 


Warning!:  Some  of  the  data  may  be  lost. 


Action:  None.  This  is  an  informational  message. 


***  INVALID  BLOCK  POINTER  CORRECTED 

Reason:  The  file  contains  an  invalid  block  pointer.  The  pointer  has  been 
corrected.  Some  of  the  data  may  be  lost. 

Action:  None.  This  is  an  informational  message. 
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RE-WRITE  OF  DATABASE  ALLOCATION  BLOCKS 

Reason:  The  database  allocation  blocks  are  being  rewritten. 

Action:  None.  This  is  an  informational  message. 

INDEX  FILE  -  LOGICAL  INDEX  VERIFICATION 

Reason:  The  contents  of  tihe  index  file  are  being  logically  verified. 

Action:  None.  This  is  an  informational  message. 

***INDEX  ENTRY  DELETED  FOR  KE\=record-key 

Reason:  A  logical  error  is  found  in  the  index  file.  The  index  entry  is  deleted. 
Action:  None.  This  is  an  informational  message. 

***INDEX  ENTRY  SET  TO  HIGH  KEY=record-/fey 

Reason:  A  logical  error  is  found  in  the  index  file.  The  index  entry  is  corrected  to 
the  high  key  for  the  lower  block. 

Action:  None.  This  is  an  informational  message. 

***INVALID  DATA  RECORD  REMOVED  FROM  INDEX 

Reason:  A  logical  error  is  foimd  in  the  index  file.  Unrecognizable  data  is  foimd 
in  an  index  entry.  The  entry  is  corrected. 

Action:  None.  This  is  an  informational  message. 

***INDEX  DATA  RECORD  DELETED  FOR  KEY=record-key 

Reason:  A  logical  error  is  foxmd  in  the  index  file.  The  index  data  record  is 
deleted. 

Action:  None.  This  is  an  informational  message. 
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***INDEX  BLOCK  ENTRY  COUNT  CORRECTED 

Reason::  A  logical  error  is  foimd  in  the  index  file.  The  number  of  index  entries  in 
an  index  block  is  in  error  and  has  been  corrected. 

Action:  None.  This  is  an  informational  message. 

***INDEX  BLOCK  USED  DATA  COUNT  CORRECTED 

Reason:  A  logical  error  is  found  in  the  index  file.  The  used  data  count  is  in  error 
and  has  been  corrected. 

Action:  None.  This  is  an  informational  message. 


*  * 

*  EXPftllDED  ACCESS  SERVER  * 

*  SAREAS  IXXXX)  HAS  ABENDED  WITH  CODE  XXXXX  * 

*  *****1,  restart  SAREAS  ASAP  ******  * 

*  * 

*******************<***********  4lr  ******  ^  ^  ^  ^  ^  ^  ^  ^  ^ 


Reason:  The  expanded  access  server  for  tape  and  robotics  has  abended.  The 
system  or  user  abend  code  is  provided. 

Action:  Consult  the  IBM  MFS  System  Codes  manual  to  determine  the  reason  for 
the  abend.  If  you  still  cannot  determine  the  problem.  Contact  Computer 
Associates  Technical  Svqjport. 


SAREAS  ixxxx)  TASK  HAS  ABENDED  WITH  CODE  XXXXX 
lASK=xxxxxxxx,  REQUEST=xxxxxxxx,  TYPE=W, 
REQUESTER=xxxxxxxx 

Reason:  A  tape  processing  task  of  the  expanded  access  server  for  tape  and 
robotics  has  abended.  The  system  or  user  abend  code,  TCB  address,  process 
request  entry  address,  process  request  type,  and  requester's  job  ID  are  provided. 

Action:  Consult  the  IBM  MVS  System  Codes  manual  to  determine  the  reason  for 
the  abend.  If  you  stills  camot  determine  the  problem.  Contact  Computer 
Associates  Technical  Support. 

Note:  The  task  will  be  restarted  automatically  and  processing  will  continue. 
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SAREA03S 


SAREA04I 


SAREA05S 


SAREA06S 


TASK  WILL  BE  RESTARTED  FOR  SAREAS  (jobname/sysid) 

Reason:  A  tape  processing  task  of  the  expanded  access  server  for  tape  and 
robotics  has  abended  and  is  being  restarted  automatically. 

Action:  None. 

DYNAMIC  ALLOCATION  ERROR  FOR  SAREAS  (jobname/sysid) 
ERRORsxxxx,  INFOsxxxx,  DSNsdsname 

Reason:  Djmamic  allocation  failed  for  the  tape  specified  by  dsname.  The 
hexadecimal  error  and  information  codes  are  provided. 

Action:  None,  the  tape  caimotbe  used.  Processing  will  continue. 


NUMBER  OF  PROCESS  REQUEST  ENTRIES  FOR  SAREAS 
(jobname/sysid)  ALLOCATED=yV,  HIGH  WATERsN 

Reason:  This  message  is  displayed  whenever  the  server  is  stopped.  You  can  use 
dre  information  provided  to  adjust  the  NREQ  initialization  parameter. 

Action:  None.  This  is  an  informational  message. 


DEVICE  TYPE  x’xxxxxxxx*  INVALID  FOR  SAREAS 
(jobname/sysid),  DSNsdsname 

Reason:  The  device  type  is  invalid  for  the  tape  specified  by  dsname.  The  server 
can  only  process  3480/3490  type  cartridge  tapes. 

Action:  None,  the  tape  cannot  be  used.  Processing  will  continue. 


AHEMPT  TO  ACCESS  SARTCP  COPIED  TAPE  FOR  SAREAS 
(Jobname/sysid)  DSNsdsnome 

Reason:  An  attempt  was  made  to  read  data  from  a  copy  of  an  archival  tape  that 
had  been  created  by  the  SARTCP  utility.  SARTCP  created  tapes  cannot  be  used 
directly.  Note,  however,. that  the  data  on  the  SARTCP  created  tape  can  be  made 
available  again  by  compacting  the  tape  to  another  tape  with  the  SARPAC  utility. 

Action:  None,  the  tape  cannot  be  used.  Processing  will  continue. 
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PRIMARY  SERVER  IS  ALREADY  ACTIVE  FOR  SAREAS 
(jobname/sysid) 

Reason:  The  primary  server  is  already  active  and  cannot  be  started  again. 

Action;  None.  This  is  an  informational  message. 

SAREAS  (XXXX)  IS  ALREADY  ACTIVE 

Reason:  The  server  is  already  active  on  this  system  and  cannot  be  started  again. 
Action;  None.  This  is  an  informational  message. 

INVALID  COMMAND  FOR  SAREAS  (jobname/sysid) 
Commar\6=xxxxxxxxxxxxxxxxxx 

Reason:  The  specified  operator  command  is  invalid. 

Action:  Reissue  the  operator  command  in  its  correct  form. 

INVALID  mmUZATION  PARAMETER  FOR  SAREAS 
(Jobname/sysid)  KEYWORD=xxx>cxxxx,VALUE=xxx>cxxxx 

Reason;  The  specified  parameter  is  invalid.  The  server  will  use  the  default  value 
for  the  parameter  and  continue  processing. 

Action:  Correct  the  initialization  parameter  in  the  start  procedure  JGL. 

INVALID  SERVER  TYPE  FOR  SAREAS  (JOBNAME/SYSiD) 
KEYWORD=xxxxxxxx,VALUE=xxxxxxxx 

Reason;  The  specified  server  type  is  invalid.  The  server  will  use  the  default  value 
ONLY  for  the  server  type  and  continue  processing. 

Action:  Correct  the  initializationparameter  in  the  start  procedure  JCL. 


THE  FOLLOWING  PARAMETERS  ARE  BEING  USED  FOR  SAREAS 
(JOBNAME/SYSiD):  KEYWORD  =  VALUE 

Reason;  A  listing  of  the  parameters  actually  used  by  the  server  is  provided  at 
startup  time. 
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Action:  None.  This  is  an  informational  message. 

XCF  XXXX  REQUEST  FAILED  FOR  SAREAS  (JOBNAME/SYSID), 
RETURN=XXXX;  REASON=XXXX 

Reason:  The  specified  XCF  request  failed.  The  hexadecimal  return  and  reason 
codes  are  provided. 

Action:  Consult  the  IBM  Authorized  Assembler  Reference  Guide  for  the  return  and 
reason  codes  to  determine  the  cause  of  the  failure.  If  you  still  cannot  determine 
the  problem.  Contact  Computer  Associates  Technical  Support. 


L-SERV  XXXX  REQUEST  FAILED  FOR  SAREAS  (JOBNAME/SYSID), 
RETURN=XXXX;  REASON=XXXX 

Reason:  The  specified  L-Serv  request  failed.  The  hexadecimal  return  and  reason 
codes  are  provided. 

Action:  Consult  the  Computer  Associates  L-Serv  System  Guide  ior  the  return  and 
reason  codes  to  determine  the  cause  of  the  failure.  If  you  still  cannot  determine 
the  problem,  Contact  Computer  Associates  Technical  Support. 


INVALID  COMMUNICATION  MECHANISM  FOR  SAREAS 
(JOBNAME/SYSID)  KEYWORD=xxxxxxxx,VALUE=xxxxxxxx 

Reason:  The  specified  communication  mechanism  is  invalid.  The  server  will  use 
the  default  value  LSERV  for  the  cormnunication  mechanism  and  continue 
processing. 

Action:  Correct  the  initialization  parameter  in  the  start  procedure  JCL. 


COMMUNICATIONS  RESET  FOR  SAREAS  (jobname/sysid) 

Reason:  The  COMMRESET  operator  command  was  successfully  executed. 
Action:  None. 

UNLOAD  COMMAND  POSTED  FOR  SAREAS  (jobname/sysid) 

Reason:  The  UNLOAD  operator  command  was  posted  to  the  tape  processing 
threads. 

Action:  None.  This  is  an  informational  message. 
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xxxxxxxx  -  INVALID  OR  MISSING  PRINTER  ID 

Reason:  The  SARINIT  initialization  parameter  xxxxxxxx  coniams  an  invalid  or 
missing  printer  ID. 


Action;  Correct  the  initjalization  parameter. 


XXXXXXXX  -  INVALID  SYSOUT  CLASS 

Reason:  The  SARINIT  initialization  parameter  arxrrjrxara:  contains  an  invalid 
SYSOUT  class. 

Action:  Correct  the  initialization  parameter. 

XXXXXXXX  -  INVALID  DESTINATION 

Reason:  The  SARINIT  initialization  parameter  xxxxxxxx  contains  an  invalid 
destination. 

Action:  Correct  the  initialization  parameter. 


XXXXXXXX  -  INVALID  FORMS  NAME 

Reason:  The  SAMNIT  initialization  parameter  xxxxxxxx  contains  an  invalid 
forms  name. 

Action:  Correct  the  initialization  parameter. 


XXXXXXXX  -  INVALID  EXTERNAL  WRITER  NAME 

Reason:  The  SARINIT  initialization  parameter  xxxxxxxx  contains  an  invalid 
external  writer  name. 

Action:  Correct  the  initialization  parameter. 


INVALID  EXTERNAL  PRINT  INTERFACE 

Reason:  An  invalid  external  print  interface  was  foimd  in  the  master  control 
record.  Only  types  JESDS  and  PGM  are  valid. 

Action:  Rim  SARINIT  to  correct  the  external  print  initialization  parameters. 


Diagnostic  and  Error  Messages  12-149 


Diagnostic  and  Error  Messages 


SAREDM07 


SAREDM08 


SAREDM09 


SAREDM10 


SAREDM1 1 


SAREDM12 


DYNAMIC  ALLOCATION  ERR=xxxx  INFO=xxxx  "" — ^ 

Reason:  Dynamic  allocation  failed  for  the  JESDS  data  set.  The  hexadecimal  error 
and  information  codes  are  provided. 


Action:  Run  SARINTT  to  correct  the  external  print  initialization  parameters. 


TOO  MANY  DISTIDS/INSTRUCTIONS  FOR  EXTERNAL  PRINT 
REQUEST 


Reason:  Too  many  distribution! identifiers  and/or  special  instructions  were 
contained  in  the  CA-Deliver  external  print  requesti 

Action:  Re-issue  the  external  print  request  with  fewer  distribution  identifiers 
and/ or  special  instructions. 


xxxxxxxx  -  INVALID  OR  MISSING  INTERFACE  TYPE 

Reason:  TheSARINIT  initialization  parameter  zxzxajxxx  contains  an  invalid  or 
missing  interface  type. 

Action:  Correct  the  initialization  parameter. 

I  ] 

XXXXXXXX  -  INVALID  OR  MISSING  PROGRAM  NAME 

Reason:  The  SARINIT  initialization  parameter  xxxxxxxx  contains  an  invalid  or 
missing  program  name. 

Action:  Correct  the  initiaHzation  parameter. 


XXXXXXXX  -  INVALID  PROGRAM  PARAMETER 

Reason:  The  SARINIT  initialization  parameter  xxxxxxxx  contains  an  invalid 
program  parameter. 


Action:  Correct  the  initialization  parameter. 


LOAD  FAILED  FOR  EXTERNAL  PRINT  INTERFACE  PROGRAM 
xxxxxxxx 

Reason:  The  external  print  interface  was  imable  to  load  piogiam  xxxxxxxx. 
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Action:  Correct  the  program  name  in  the  corresponding  external  print 
initialization  parameter.  If  it  is  already  correct,  supply  the  STEPLIB  DD  statement 
for  the  library  that  contains  the  program. 


INVALID  FUNCTION  CODE 

Reason:  The  requested  function  code  is  invalid.  This  is  a  problem  in  the  coding 
of  the  external  print  interface  product. 

Action:  Contact  the  vendor  who  supplied  the  external  print  interface  product  for 
a  resolution. 


INVALID  INITIALIZATION  TOKEN  PASSED 

Reason:  The  requested  initialization  token  is  invalid,  probably  the  result  of  an 
improper  initialization  request.  This  is  a  problem  in  the  coding  of  the  external 
print  interface  product. 

Action:  Contact  the  vendor  who  supplied  the  external  print  interface  product 
for  a  resolution. 


INVALID  ACCESS  TOKEN  PASSED 

Reason:  The  requested  access  token  is  invalid,  probably  the  result  of  an 
improper  access  request.  This  is  a  problem  in  the  coding  of  the  external  print 
interface  product. 

Action:  Contact  the  vendor  who  supplied  the  external  print  interface  product 
for  a  resolution. 


INVALID  EXTERNAL  PRINT  RECORD 

Reason:  The  external  print  record  is  invalid.  This  is  a  problem  in  the  coding  of 
the  external  print  interface  product. 

Action:  Contact  the  vendor  that  supplied  the  external  print  interface  product 
and  have  them  correct  the  error.. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  at  the  same  release 
level.  CA-View  will  not  execute. 
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Action:  Correct  the  problem  and  retry. 


GCR  NOT  FOUND  FOR  lD=xxxxxxxxxxxx,  GEN=xxxxx, 
SEQsxxxxx 

Reason:  The  group  control  record  for  the  archived  SYSOUT  could  not  be  found 
in  the  database.  This  is  normally  caused  by  a  user  deleting  the  SYSOUT  group 
between  the  time  it  was  queued  for  external  printing  and  the  time  that  the 
external  print  actually  occurs. 

Action:  None.  The  SYSOUT  group  is  no  longer  available. 


PAGE  SELECTION  TEXT  CONFLICTS  WITH  PAGE  AND/OR  RECORD 
SPECIFICATION 

Reason:  A  page  and/ or  record  range  was  specified  for  an  external  print  of  a 
page  selection  request  for  a  SYSOUT  group. 

Action:  Resubmit  the  external  print  request  omitting  the  page  and/or  record 
range. 


PAGE  SELECTION  TEXT  SPECIFIED  WITHOUT  A  VALID  LOGICAL 
VIEW 

Reason:  The  page  selection  text  specification  requires  a  valid  logical  view. 
Action:  Resubmit  the  external  print  request  with  a  valid  logical  view. 


SYSOUT  IS  NOT  ON  DISK  AND  ITS  INDEX  IS  UNAVAILABLE  FOR 
PAGE  SELECTION 

Reason:  The  SYSOUT  group  does  not  currently  reside  on  DISK  and  its  page 
selection  is  not  available. 

Action:  Reload  the  SYSOUT  group  to  disk  and  then  resubmit  the  external  print 
request. 


REQUESTED  SYSOUT  DOES  NOT  EXIST  ON  ANY  TAPE  BACKUP 
DATASET 

Reason:  The  SYSOUT  group  requested  for  the  external  print  could  not  be  found 
on  any  backup  tape. 
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Action:  None.  The  SYSOUT  group  is  not  available  on  tape. 


THE  TAPE  FILE  WAS  NOT  THE  SELECTED  SYSOUT  GROUP  -  USE 
SARTCP  TO  MAP  THE  TAPE 

Reason:  The  SYSOUT  group  located  on  the  backup  tape  for  external  printing  is 
not  the  SYSOUT  as  referenced  in  the  master  index. 


Action:  Use  the  SARTCP  utility  to  map  and  correct  the  backup  tape. 


BACKUP  TAPE  DOES  NOT  EXIST 

Reason:  The  backup  tape  could  not  be  foimd  in  the  master  index.  This  is 
normally  caused  by  the  backup  cycle  deleting  the  tape  prior  to  completion  of  the 
load  request. 

Action:  None.  The  SYSOUT  group  is  no  longer  available. 


DYNAMIC  ALLOCATION  FAILED  FOR  TAPE  FILE,  ERROR  CODE  - 
xxxx,  INFO  CODE  -  xxxxx 

Reason:  Dynamic  allocation  failed  for  allocating  the  backup  tape  file.  The 
hexadecimal  error  and  mformation  codes  are  provided. 

Action:  Consult  the  online  retrieval  HELP  facility  for  a  description  of  the 
d5mamic  allocation  errcw  code.  Take  appropriate  Action  to  correct  the  allocation 
error,  then  resubmit  the  print  request. 


I/O  ERROR  POSITIONING  TAPE 

Reason:  A  permanent  I/O  error  occurred  attempting  to  position  the  archival 
tape  to  retrieve  the  SYSOUT  group  for  external  printing. 

Action:  Resubmit  the  request.  If  the  I/O  error  occurs  again,  use  the  SARTCP 
utility  to  map  and  correct  the  tape. 


PERMANENT  I/O  ERROR  ON  INPUT  TAPE 

Reason:  A  permanent  I/O  error  occurred  attempting  to  read  SYSOUT  data  from 
a  backup  tape. 
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Action:  Resubmit  the  request  If  the  I/O  error  occurs  again,  use  the  SARTCP 
utility  to  map  and  correct  the  tape.  Also  see  Chapter  8,  "Backing  Up  and 
Recovering  the  Database,"  for  recovery  methods. 


VIEW  NOT  FOUND 

Reason:  The  specified  view  does  not  exist  in  the  master  index. 

Action:  Verify  the  existence  of  the  view.  If  the  view  number  was  specified 
incorrectly,  change  the  parameter  specification,  then  resubmit  the  external  print 
request. 


SELECT  SPECIFIED  WITHOUT  A  VALID  LOGICAL  VIEW 

Reason:  The  external  print  request  specifying  the  SELECT  keyword  has  failed 
because  no  views  exist  for  the  SYSOUT. 

Action:  Do  one  of  the  following: 

■  Remove  the  SELECT  keyword,  then  resubmit  the  external  print  request. 

■  Specify  a  view  number  that  contained  page  indexing  criteria  when  the 
SYSOUT  was  archived,  then  resubmit  the  request. 

Be  aware  that  page  indexing  occurs  only  during  archival. 


ERROR  OCCURRED  AHEMPTING  TO  READ  IN  THE  INDEX  FOR  THE 
SYSOUT 

Reason:  The  external  print  request  specif)dng  the  SELECT  keyword  has  failed 
because  an  I/O  error  occurred  while  opening  or  reading  the  page  index  data 
from  the  database.  The  data  is  imreadable. 

Action:  Do  one  of  the  following; 

■  Remove  the  SELECT  keyword,  then  resubmit  tine  external  print  request. 

■  Rebuild  the  page  index  data  as  follows: 

Note:  The  index  can  be  rebuilt  only  by  re-archiving  the  SYSOUT. 

1 .  Reprint  the  SYSOUT  to  a  held  class . 

2.  Delete  the  SYSOUT  from  CA-View. 

3.  Release  the  SYSOUT  to  CA-View  for  re-archival;  retaining  the  same 
SYSOUT-ID; 

4.  Resubmit  the  print  request. 
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SYSOUT  HAS  NOT  BEEN  INDEXED  FOR  THE  LOGICAL  VIEW 

Reason:  The  external  print  request  specifying  the  SELECT  ke5word  has  failed 
because  indexing  has  not  been  established  for  the  view. 

Action:  Establish  indexing  criteria  for  the  view  if  it  does  not  already  exist.  Re- 
archive  the  SYSOUT.  Be  aware  that  page  indexing  occurs  only  during  archival. 


NO  PAGES  FOUND  THAT  MATCH  SELECTION  TEXT 

Reason:  The  external  print  request  specifying  the  SELECT  keyword  has  failed 
because  the  SELECT  text  ID  did  not  match  any  index  selection. 

Action:  Check  that  the  SELECT  text  and  index  selection  criteria  are  as  intended. 
The  SYSOUT  would  have  to  be  re-archived  if  the  page  indexing  criteria  is 
changed.  Be  aware  that  page  indexing  occurs  only  during  archival. 


FSA  CONNECT  FAILED  FOR  fssname,  SSOBRETN=nnnn 
FSIRESN=nnnn 

Reason:  The  connect  request  from  the  FSA  to  JES  failed;  the  return  and  reason 
codes  are  provided. 

Action:  The  FSA  is  terminated. 


FSA  DISCONNECT  FAILED  FOR  fssname, 
SSOBRETN=nnnn,FSIRESN=nnnn 

Reason:  The  disconnect  request  from  the  FSA  to  JES  failed;  the  return  and  reason 
codes  are  provided. 

Action:  The  FSA  is  terminated. 


FSA  SEND  FAILED  FOR  fssname,  RC=nnnn 

Reason:  A  send  request  from  the  FSA  to  JES  failed;  the  return  and  reason  codes 
are  provided. 

Action:  The  FSA  is  terminated. 
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FSA  GETDS  FAILED  FOR  fssname,  RCsnnnn 

Reason:  A  get  data  set  request  from  the  FSA  to  JES  failed;  the  return  and  reason 
codes  are  provided: 

Action:  The  FSA  is  abnormally  terminated. 

FSA  RELDS  FAILED  FOR  fssname,  RC=nnnn 

Reason:  A  release  data  set  request  from  the  FSA  to  JES  failed;  the  return  and 
reason  codes  are  provided. 

Action:  The  FSA  is  abnormally  terminated. 

FSA  GETREC  FAILED  FOR  fssname,  RC=nf)nn,  GLRFLGSl=nnnn 

Reason:  A  get  record  request  from  the  FSA  to  JES  failed;  the  return  and  reason 
codes  are  provided. 

Action:  The  FSA  is  abnormally  terminated. 

FSA  GETREC  PERMANENT  I/O  ERROR  FOR  fssname 

Reason:  ApermanentI/0  error  occurred  attempting  to  get  a  record  from  JES. 
Action:  Processing  for  the  data  set  is  ended,  and  execution  continues. 

FSA  GETREC  LOGIC  ERROR  FOR  fssname 

Reason:  A  logical  I/O  error  occurred  attempting  to  get  a  record  from  JES. 
Action:  Processing  for  the  data  set  is  ended,  and  execution  continues. 

fssname  OPEN  FAILED  FOR  DEVICE  DD  STATEMENT  ddname 

Reason:  An  attempt  to  open  the  input  parameter  file  for  the  device  failed. 
Action:  The  FSA  is  terminated. 
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fssname  FIRST  CNTL  STATEMENT  IS  NOT  “TYPE=” 

Reason:  The  first  control  statement  in  the  input  parameter  file  for  the  device 
must  be  a  TYPE=  statement. 

Action:  The  FSA  is  terminated.  Add  the  TYPE=  control  statement. 


UNDEFINED  DATA  COLLECTOR  “TYPE”  FOR  fssname 

Reason:  An  invalid  data  collector  name  was  specified  on  the  TYPE=  statement  in 
the  input  parameter  file  for  the  device. 

Action:  The  FSA  is  terminated.  Correct  the  TYPE=  control  statement. 


LOAD  MODULE  module  NOT  FOUND  FOR  fssname 

Reason:  The  load  module  was  not  found  for  the  FSA. 

Action:  The  FSA  is  terminated.  Verify  that  the  correct  step/job  libraries  were 
specified  in  the  FSS  startup  procedure. 

SJF  RETRIEVE  ERROR  FOR  fssname,  RC=nnnn 

Reason:  An  error  occurred  attempting  to  retrieve  the  OUTPUT  statements  for  a 
data  set. 

Action:  The  data  set  is  placed  on  hold  and  not  processed. 

fssname  CONTROL  STATEMENT  -  xxxxxxxxxxxxxxxxxx 

Reason:  A  copy  of  the  input  parameter  statement  is  logged. 

Action:  None.  This  is  an  informational  message. 

fssname  NOT  STARTED  BY  JES 

Reason:  An  attempt  has  been  made  to  start  the  FSS  directly  with  a  START 
operator  command,  b5^ssing  JES. 

Action:  Use  the  appropriate  JES  command  to  start  the  FSS. 
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INVALID  START  COMMAND  FOR  fssname 

Reason;  An  invalid  start  conunand  was  issued  for  the  FSS. 
Action:  Use  the  appropriate  JES  command  to  start  the  FSS. 


FSS  CONNECT  FAILED  FOR  fssname,  SSOBRETN=nnnn 
FSIRESN^nnnn 

Reason;  The  connect  request  from  the  FSS  to  JES  failfed. 

Action:  Take  the  appropriate  action,  based  on  the  return  and  reason  codes 
provided. 


FSS  DISCONNECT  FAILED  FOR  fssname, 
SSOBRETN=/7nn/7,FSIRESN=nnnn 

Reason;  The  disconnect  reqnestfrom  the  FSS  to  JES  failed;  the  return  and  reason 
codes  are  provided. 

Action:  Take  the  appropriate  action,  based  on  the  return  and  reason  codes 
provided. 


*****  MAXIMUM  LINES  EXCEEDED  ON  VTAM  PRINTER  ***** 

Reason;  Your  print  request  exceeded  the  maximum  number  of  lines  permitted 
during  online  VTAM  print  processing.  This  message  can  also  occur  on  nom 
VTAM  printers  as  an  indication  that  an  error  occurred  while  printing  on  both 
devices  simultaneously. 

Action:  Do  one  of  the  following: 

■  Print  in  smaller  segments. 

■  Increase  the  maximum  permitted  for  this  device  by  using  the  DEFine  DEVice 
facility. 

■  Increase  the  maximum  permitted  for  all  devices  by  using  SARINIT 
parameter  VPRTMAXO: 

■  Make  mxiltiple  separate  print  requests. 
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***  MAXIMUM  LINK  EXCEEDED  ON  CMASPOOL  PRINTER  *** 

Reason:  Yoiir  print  request  exceeded  the  maximum  number  of  lines  permitted 
during  GA-Spool  print  processing.  This  message  can  also  occur  on  non-VTAM 
printers  simultaneously. 

Action:  Do  one  of  the  following: 

■  Print  in  smaller  segments. 

■  Increase  the  maximum  permitted  for  this  device  by  using  the  DEFine  DEVice 
facility. 

■  Make  multiple  separate  print  requests. 

INVALID  GROUP  CONTROL  RECORD  \D-xxxxxxxxxxxx, 
GENsnnnn,  AND  SEQ=nnnn  ENCOUNTERED,  PROGRAM 
TERMINATED. 

Reason:  An  attempt  was  made  to  add  or  update  a  SYSOUT  group  index  record 
with  an  invalid  generation' and  sequence  niunber.  Processing  is  terminated  with  a 
USER  100  abend. 


Action:  If  this  occurs  during  a  SARDBASE  REORG,  the  program  will 
automatically  correct  the  error  and  you  can  ignore  this  message.  If  bad  records 
reside  in  the  database  from  prior  releases  of  the  product,  the  database  will  have 
to  be  corrected  with  the  VERIFY  control  statement  from  the  SARDBASE  utility. 
Otherwise  the  processing  can  be  resumed.  For  more  information,  please  Contact 
Computer  Associates  Technical  Support. 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP. 

INVALID  bik 

Reason:  A  GA-View  program  has  terminated,  and  a  dump  was  generated.  In  this 
message,  blk  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  IFB,  SFB,  XFB>  or  DBB).  It  may  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program  detected  the  problem. 

Action:  Send  the  dump  to  Computer  Associates  Technical  Support  Restart 
whatever  program  was  terminated.  If  the  problem  recurs,  run  SARDBASE 
VERIFY  on  the  database.  If  the  problem  still  occurs,  contact  Computer  Associates 
Technical  Support. 


OPEN  FAILED  FOR  ACCOUNTING  FILE 

Reason:  The  SARAO  DD  statement  is  not  provided  and  is  required. 
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Action:  Specify  SARAO  DD  statement  in  execution  JCL,  then  resubmit  the  job. 

MULTIPLE  EXTENTS  FOR  ACCOUNTING  FILE 

Reason:  The  accounting  file  has  multiple  extents. 

Action:  Recreate  the  accounting  file,  then  resubmit  the  job. 

UTILITY  PROCESSING  SUCCESSFULLY  COMPLETED 

Reason:  Processing  has  successfully  completed. 

Action:  None.  This  is  an  informational  message. 

SYNTAX  ERROR 

Reason:  The  specified  option  statement  contains  a  syntax  error. 

Action:  Correct  the  option  statement,  then  resubmit  the  job. 

OPTION  NOT  FOUND 

Reason:  The  specified  option  is  not  valid. 

Action:  Correct  the  option,  then  resubmit  the  job. 

INVALID  VALUE 

Reason:  The  specified  valuers  invalid  for  the  option. 

Action:  Correct  the  value,  then  resubmit  the  job. 

DUPLICATE  STATEMENT 

Reason:  The  option  has  been  previously  specified. 

Action:  Correct  the  problem,  then  resubmit  the  job. 
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TVSER1/TVSER2  SPECIFIED  WITHOUT  THE  OTHER  IN  THE  STORAGE 
GROUP 

Reason:  Only  one  volume  serial  number  for  a  range  of  volumes  has  been 
specified. 

Action:  Correct  the  problem,  then  resubmit  the  job. 


CODE  PAGE  name  IS  NOT  AVAILABLE 

Reason:  The  CODEPAGE  initialization  parameter  references  a  codepage 
member  name  that  does  not  exist. 

Action:  Ensme  that  the  codepage  name  indicated  on  the  error  message  resides  in 
your  STEPLIB/  JOBLIB;  or  link-list  and  renm. 

TAPE  VOLUME  SERIAL  NUMBERS  DO  NOT  END  WITH  A  NUMERIC 

Reason:  One  of  the  volume  serial  numbers  for  a  range  of  tape  volumes  does  not 
end  with  numeric  characters. 

Action:  Correct  the  volume  serial  number,  then  resubmit  the  job. 


TAPE  VOLUME  SERIAL  NUMBERS  ARE  DIFFERENT  FORMATS 

Reason:  When  specifying  a  range  of  tape  volumes,  the  volume  serial  numbers 
must  be  of  the  same  format. 

Action:  Correct  the  volume  serial  numbers,  then  resubmit  the  job. 


SECONDARY  DISK  STORAGE  DRIVER  NOT  FOUND  OR  NOT 
AUTHORIZED 

Reason;  The  DSK2DRVR  parameter  specifies  the  name  of  a  load  module  which? 
could  not  be  foimd  or  is  not  authorized. 

Action:  Verify  that  DSE2DRVR?  specifies  the  name  of  an  authorized  load  module 
accessible  to  SARINIT. 


LANGUAGE  CODE  x  IS  NOT  INSTALLED 

Reason;  There  are  no  panels  for  the  indicated  language  code  in  the  CA-View 
database. 
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Action:  Either  install  the  desired  panels  or  specify  a  language  code  for  panels 
which  are  already  in  the  database. 


JOB/USER  NOT  AUTHORIZED  TO  ACCESS  DATA 

Reason:  The  authorization  user  exit  does  not  allow  the  job  or  user  to  access  the 
database. 

Action:  Consult  the  system  programming  group  or  security  group  to  determine 
the  reason  why  the  authorization  user  exit  explicitly  denies  access  to  the 
database. 

PROCESSING  TERMINATED  DUE  TO  PREVIOUS  ERRORS 

Reason:  Previous  errors  have  occurred. 

Action:  Take  the  appropriate  action  for  the  previous  errors. 


UTILITY  PROCESSING  SUCCESSFULLY  COMPLETED 

Reason:  Processing  has  successfully  completed. 

Action:  None.  This  is  an  mformational  message. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  of  the  same  release 
level.  CA-View  does  not  execute. 

Action:  Correct  the  problem  and  retry. 


GENs,  TAPESEQ=  ONLY  VALID  DURING  FIRST  INIT  OF  DATABASE; 
IGNORED. 

Reason:  The  GEN=  and  TAPSEQ=  initialization  parameters  can  only  be  used  for 
newly  created  databases. 

Action:  None.  The  unacceptable  parameters  are  ignored. 
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FINDLIM  MUST  BE  LESS  THAN  OR  EQUAL  TO  FINDMAX 

Reason::  The  second,  portion  of  the  FINDLIM  initialization  parameter  is  a 
maximum:  for  the  parameter  (that  is,  FIiSnDLM=limiLmax-Iiinit). 


Action:  Correct  the  parameter  and  renmi 


TAPE  STORAGE  GROUP  NAMES  MUST  BE  UNIQUE 

Reason:  The  tape  storage  group  names,  defined  by  the  STORGRPn  initialization 
parameters  must  be  unique. 

Action:  Correct  the  STORGRPn  parameter  and  rerun. 


TAPE  STORAGE  VOLSER  RANGES  MUST  NOT  PARTIALLY  OVERLAP 

Reason:  The  tape  Volser  ranges  specified  for  the  STORGRPn  initialization 
parameters  must  be  either  exactly  the  same,  or  completely  disjoint.  No  partial 
overlaps  are  allowed. 

Action:  Correct  the  tape  Volser  ranges  for  the  STORGRPn  parameter  and  rerun. 


ERO  OPTION  IS  NOT  ACTIVE 


Reason:  The  EROOPT=NG  initialization  parameter  was  specified  and  all  of  the 
ERO  parameters  have  been  removed  from  the  CA-View  database. 

Action:  None.  This  is  an  informational  message. 


PARAMETER  CONFLICT  WITH  ERO  PARAMETER  SPECIFICATION 
AND  EROOPT=NO  SPECIFICATION 

Reason:  The  EROOPT=NO  initialization  parameter  was  specified,  indicating  that 
all  ERO  options  are  to  be  removed  and  new  ERO  initialization  parameters  are 
being  specified. 

Action:  Either  remove  the  EROOPT^NO  parameter,  or  remove  the  ERO 
initialization  parameters  and  rerun. 


DEFAULT  AHRIBUTES  USED  FOR  OUT  DATASET 

Reason:  Either  RECFM,  LRECL,  or  BLKSIZE  has  been  omitted  for  the  output 
file.  Default  attributes  have  been  used. 
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Action:  Verify  that  the  default  attributes  have  been  desired. 


INVALID  DCB  AHRIBUTES  FOR  OUT  DATASET 

Reason:  The  output  fUe  has  been  assigned  an  invalid  DCB  attribute. 

Action:  Correct  the  DCB  specifications  for  the  output  file. 

INVALID  GENERATION  IN  PARM  FIELD 

Reason:  An  invalid  generation  number  has  been  passed  to  the  program  in  the 
parm  field. 

Action:  Correct  the  problem  and  start  SARMFP  again. 


INVALID  SORT  FIELD  NAME  xxxxxxxx 

Reason:  One  of  the  options,  MSORTl,  MSORT2,  etc.,  has  been  given  an  invaUd 
value.  The  field  is  ignored  and  processing  continues. 

Action:  Correct  the  option. 

DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  of  the  same  release 
level.  CA-View  does  not  execute. 

Action:  Correct  the  problem  and  retry. 


SARMFP  IS  NOT  A  STARTED  TASK 

Reason:  An  attempt  has  been  made  to  execute  SARMFP  as  other  than  a  started 
task. 

Action:  Execute  SARMFP  by  using  the  start  operator  command. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  of  the  same  release 
level.  CA-View  does  not  execute. 

Action:  Correct  the  problem  and  retry. 
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EXPANDED  RETENTION  WAS  NEVER  INITIALIZED 

Reason:  The  Expanded  Retention  Option  (ERO)  has  never  been  initialized. 
Action:  Run  SARINTT  to  initialize  the  Expanded  Retention  Option. 

MASTER  INDEX  IS  ALREADY  IN  USE 

Reason:  Another  consolidation  task  with  the  same  database  is  already  executing. 
Action:  Correct  the  problem. 


VERIFY  SARPAC  NOT  ACTIVE  ON  SYSTEM  xxxx,  REPLY  Y/N  TO 
CONTINUE 

Reason:  The  master  index  indicates  that  the  archival  task  is  already  active  on 
system  xxxx.  This  message  can  also  be  issued  if  the  archival  task  abended  or  the 
system  crashed  the  last  time  the  archival  task  was  active. 

Action:  Verify  whether  the  archival  task  is  actually  active  on  the  specified 
system.  If  it  is,  reply  N  to  terminate  this  task;  if  it  is  not,  reply  Y  to  continue. 


Warning!  Never  run-the  art^val  task  for  the  same  index  file  on  more  than 
one  system  at.ihes;^e  time  because  this  c^  destroy  the  master  index. 


***  ERROR  ON  INPUT  TAPE  *** 

Reason:  An  error  occurs  while  reading  the  input  tape. 
Action:  See  the  associated  SARTPIXx  message. 

***  ERROR  ON  OUTPUT  TAPE  *** 

Reason:  An  error  occurs  while  writing  to  the  output  tape. 
Action:  See  the  associated  SARTPOxx  message. 


NO  SYSOUT  GROUPS  REQUIRE  CONSOLIDATION 

Reason:  There  are  no  SYSOUT  groups  on  expired  GA-View  backup  tapes, 
therefore  consolidation  is  not  necessary. 
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Action:  None.  This  is  an  informational  message. 


xxxxxSYSOUT  GROUPS  COPIED 

Reason:  Tape  consolidation  has  completed  and  copied  SYSOUT  groups. 

Action:  None.  This  is  an  informational  message. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  of  the  same  release 
level.  CA-View  does  not  execute. 

Action:  Correct  the  problem  and  retry. 


SYSIN  CONTROL  CARDS  GOVERNING  THIS  SARPAC 

Reason:  Optional  SYSIN  control  statements  are  being  used  for  this  run  of 
SARPAC. 


Action:  None.  This  is  an  informational  message. 


NO  TAPESEQ=  or  STORGRP=  FOUND 

Reason:  SYSIN  control  statements  did  not  specify  either  a  storage  group  or  tape 
sequence  number. 

Action:  Either  remove  the  optional  SYSIN  DD  statement,  or  use  the  TAPESEQ= 
or  STORGRP=  control  statement; 


INVALID  OR  EXTRANEOUS  CONTROL  CARD  FOUND 

Reason:  Only  one  STOPGRP=  or  one  TAPESEQ=  control  statement  is  valid  as 
SYSIN. 

Action:  Use  only  one  control  statement  for  each  run  of  SARPAC.  You  may  need 
to  run  SARPAC  multiple  times  to  accomplish  the  desired  result. 
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STORAGE  GROUP  NOT  DEFINED  IN  DATABASE 

Reason:  SYSDSI  control  statement  STORGRP=  specified  a  storage  group  whose 
definition  does  not  currently  exist  in  the  database  via  the  SARINTT  parameter's 
STORGRPm. 


Action:  Check  the  storage  group  name  for  misspelling.  If  the  storage  group 
name  is  correct,  be  sure  the  database  name  is  correct.  The  storage  group  name 
must  be  correct,  and  a  backup  cycle  must  have  run  to  set  the  storage  group  name 
in  the  reports  in  the  database.  SARPAC  does  not  read  the  ERO  table  directly. 


‘‘WARNING***  RUN  SARPAC  TO  COPY  TAPES  FOLLOWING 
MERGE  OF  DATABASES 

Reason:  The  database  contains  references  to  tape  volumes  owned  by  another 
database.  This  condition  is  the  result  of  a  database  merge.  Note:  This  message 
continues  to  appear  even  after  all  tape  volumes  have  been  copied  until  the  started 
task  backup  cycle  is  executed. 

Action:  Rim  SARPAC,  as  necessary,  to  copy  the  SYSOUT  groups  on  tape  to  new 
tape  volumes  owned  by  this  database  and  then  execute  a  backup  cycle. 


SYNTAX  ERROR  IN  KEYWORD  PARAMETER  REPORT 

Reason:  The  SARPAC  parameter  must  be  VIEW-database-name,REPORT,  or 
VIEW-database-name.  The  parameter  specified  was  not  the  keyword  IMPORT. 

Action:  Correct  the  parameter  and  re-nm. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  load  modules  and  the  database  are  not  at  the  same  release 
level.  CA-Deliver-direct-to-CA-View  archival  will  not  operate. 

Action:  Set  the  version  of  the  database  (with  the  VERSION  control  statement  of 
the  SARDBASE  utility)  to  the  current  release  level,  then  resubmit  the  job. 


I/O  ERROR  WRITING  PAGE  INDEX  FOR  SYSOUT  -  PAGE  INDEX 
DELETED 

Reason:  An  I/O  error  occurs  while  writing  out  the  index  data  for  the  SYSOUT 
group.  Any  index  data  already  written  is  deleted. 

Action:  Correct  the  error  with  the  database. 
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DATABASE  database-name  FULL  -  REPLY  R  (RETRY)  OR  T 
aERMINATE) 

Reason:  There  is  no  more  space  in  the  database  to  hold  direct-to-CA-View 
archival  reports  from  CA-Deliver. 

Action:  Either  create  more  space  in  the  database  by  deleting  SYSOUTS  or  adding 
more  space  to  the  database  by  either  ADDDS  or  SARDBASE  and  reply  R  to  retry, 
or  reply  T  to  terminate  (abend)  the  application  job. 


INVALID  REPLY 

Reason:  An  invalid  reply  to  SARPAM24  was  given. 
Action:  See  SARPAM24  and  reply  accordingly. 


(CARD  xxxx)  INVALID  CONTROL  CARD  control  card 

Reason:  A  permanent  archival  control  card  is  invalid.  The  backup  cycle  of  the 
CA-View  started  task  will  terminate  with  a  UOOOl  user  abend. 

Action:  Correct  the  control  card,  then  restart  the  started  task  to  complete  the 
backup  cycle. 


(CARD  xxxx)  INVALID  ID  xxxxxxxxxxxx+  -  SKIPPING  TO  NE)^ 
CONTROL  CARD 

Reason:  The  SYSOUT  identifier  on  a  permanent  archival  control  record  is  too 
long.  The  backup  cycle  of  the  CA-View  started  task  will  terminate  with  a  UOOOl 
user  abend. 

Action:  Correct  the  control  card,  then  restart  the  started  task  to  complete  the 
backup  cycle. 


(CARD  xxxx)  INVALID  KEYWORD  xxxxxxxx+  FOR 
ID=xxxxxxxxxxxx  -  SKIPPING  TO  NEXT  CONTROL  CARD 

Reason:  The  keyword  on  a  permanent  archival  control  record  is  too  long.  The 
backup  cycle  of  the  CA-View  started  task  wiU  terminate  with  a  UOOOl  user  abend. 

Action:  Correct  the  control  card,  then  restart  the  started  task  to  complete  the 
backup  cycle. 
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(CARD  xxxx)  INVALID  VALUE  FOR  KEYWORD=xxxxxxxx, 
iD=xxxxxxxxxxxx  -  SKIPPING  TO  NEXT  CONTROL  CARD 

Reason:  The  value  for  the  keyword  on  a  permanent  arciiival  control  record  is 
invalid.  The  backup  cycle  of  the  CA-View  started  task  will  terminate  with  a 
UOOOl  user  abend. 

Action:  Correct  the  control  card,  then  restart  the  started  task  to  complete  the 
backup  cycle. 


(CARD  xxxx)  EXCESSIVE  OPERANDS  FOR  KEYWORD=xxxxxxxx, 
IDsXXXXXXXXXXXX  -  SKIPPING  TO  NEXT  CONTROL  CARD 

Reason;  The  ke3rword  on  a  permanent  archival  control  record  contains  too  many 
operands.  The  backup  cycle  of  the  CA-View  started  task  will  terminate  with  a 
UOOOl  user  abend. 

Action:  Correct  the  control  card,  then  restart  the  started  task  to  complete  the 
backup  cycle. 


KEYWORD  X  CONFLICTS  WITH  KEYWORD  /  FOR  ID=z,  x 
ASSUMED 

Reason:  The  specified  keywords  cannot  be  specified  on  the  same  control 
statement  and  are  mutually  exclusive.  The  message  is  issued  in  conjimction  with 
the  specification  of  the  Expanded  Retention  option  ALL,  LAST,  and  MARK 
parameters. 

Action:  Execution  continues  with  the  assumed  specification.  Change  the 
Expanded  Retention  Option  control  statement  to  specify  either  ALL,  LAST,  or 
MARK. 


PC  TRANSMIHAL  QUEUE  FULL  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  PC  transmittal  queue  is  full  for  the  user. 

Action;  Have  the  user  transmit  his  queue  and  clear  the  entries. 


PC  DESTINATION  INVALID  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason;  The  destination  specified  must  be  of  the  format  PC  user  ID. 


Action:  Correct  the  destination. 
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USER  NOT  DEFINED  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  user  ID  specified  in  the  destination  is  not  defined  to  CA- View. 


Action:  Correct  the  destination  or  define  the  user  ID  to  CA-View. 


UNEXPECTED  RETURN  CODE  -  x  UNABLE  TO  LOAD  VTAM  DEVICE 
DRIVER  xxxxxxxx 

Reason:  Your  print  request  specified  the  synon5nn  for  a  VTAM  Print  Option 
device.  The  DEFine  DEVice  specification  for  that  synonym  specified  that  the 
indicated  special  device  driver  was  to  be  used  when  doing  the  printing,  but  that 
device  driver  could  not  be  found. 

Action:  Either  correct  the  device  driver  specification  on  the  VTAM  DEVICE 
ATTRIBUTE  PANEL  of  the  DEFine  DEVice  facility,  or  make  the  device  driver 
accessible  by  putting  it  in  the  CA-View  LOADLIB,  or  in  a  library  concatenated  to 
CA-View  LOADLIB. 


UNABLE  TO  LOAD  DEVICE’S  USER  EXIT  xxxxxxxx 

Reason:  Your  print  request  specified  the  synonym  for  a  real  device.  The  DEFine 
DEVice  specification  for  that  synonym  specified  that  the  indicated  special  user 
exit  was  to  be  used  when  doing  the  printing,  but  that  user  exit  could  not  be 
formd. 


Action:  Either  correct  the  device  driver  specification  on  the  appropriate  DEVICE 
ATTRIBUTE  PANEL  of  the  DEFine  DEVice  facility,  or  make  the  device  driver 
accessible  by  putting  it  in  the  CA-View  LOADLIB^  or  in  a  library  concatenated  to 
CA-View  LOADLIB: 


SYSOUT  RESTORE  STARTED 

Reason:  This  message  indicates  the  start  of  the  restore  process. 
Action:  None.  This  is  an  informational  message. 


ERROR  OPENING  DATABASE 

Reason:  The  database  specified  by  the  FARM  parameter  of  the  execution  JCL 
cannot  be  opened.  This  message  accompanies  a  SARDBto  message  indicating 
the  nature  of  the  error. 
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Action:  Verify  the  correct  database  prefix  is  specified  in  the  PAKM  parameter  of 
the  execution  JCL.  Otherwise,  see  the  explanation  and  action  of  the  SARDBIxx 
message  for  resolution. 


ERROR  OPENING  INDEX  FILE 

Reason:  An  error  occurs  while  opening  the  master  index.  The  restore  process 
cannot  access  this  master  index  data,  and  is  terminated.  This  message 
accompames  a  SARDBIxx  message  indicating  the  nature  of  the  error. 

Action:  Ensure  that  ttie  restore  process  by  using  the  RESTORE  control  statement 
of  the  SARDBASE  utility  completes  successfully.  See  the  explanation  and  action 
of  the  SARDBIxx  message  for  resolution. 


ERROR  READING  MASTER  CONTROL  RECORD 

Reason:  An  error  occurs  while  reading  the  master  control  record.  This  message 
accompames  a  SARDBIxx  message  indicating  the  nature  of  the  error. 

Action:  Ensure  that  the  restore  process  by  using  the  RESTOME  control  statement 
of  the  SARDBASE  utility  completes  successfuUy.  See  the  explanation  and  action 
of  the  SARDBIxx  message  for  resolution. 


ERROR  OPENING  FM.E  FOR  PANEL=xxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  panel  to  the 
database.  This  message  accompanies  a  SARDBIcx  message  indicating  the  nature 
of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 

ERROR  WRITING  FILE  FOR  PANEL=xxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  panel  to  the 
database.  This  message  accompames  a  SARDBIxx  message  indicating  the  nature 
of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBIicx  message  for  resolution. 
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ERROR  UPDATING  INDEX  RECORD  FOR  PAHEL=xxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  panel  to  the 
database.  This  message  accomparues  a  SARDBIxx  message  indicating  the  nature 
of  the  error. 


Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 


ERROR  OPENING  FILE  FOR  SYSO[n=xxxxxxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  SYSOUT  to  the 
database.  This  message  accompanies  a  SARDBIxx  message  indicating  the  nature 
of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 


ERROR  WRITING  FILE  FOR  SYSOUUxxxxxxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  SYSOUT  to  the 
database.  This  message  accompanies  a  SARDBIicx  message  indicating  the  nature 
of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 


ERROR  UPDATING  INDEX  RECORD  FOR  SYSOUT=xxxx>cxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  SYSOUT  to  the 
database.  This  message  accompanies  a  SARDBLcx  message  indicating  the  nature 
of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 


ERROR  READING  INDEX  FILE 

Reason:  An  error  occurs  while  reading  an  index  record  from  the  master  index  of 
the  database.  This  message  accompanies  a  SARDBIxx  message  indicating  the 
nature  of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 
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ABNORMAL  END  TO  SORT,  RETURN  CODE=xxxx 

Reason:  The  sort  phase  of  the  restore  process  ends  with  the  specified  non-zero 
return  code. 

Action:  The  non-zero  return  code  from  the  sort  phase  can  be  caused  by  a  critical 
error  as  indicated  by  a  previous  SARRSPxx  message,  a  missing  SYSOUT  DD 
statement  (return  code  20),  or  a  sort  error  as  indicated  in  the  sort  message  data 
set.  Take  the  appropriate  action,  then  resubmit  the  job. 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  program  k>ad  modules  and  the  database  are  not  at  the  same  release 
level.  This  is  normally  caused  by  the  STEPLIB,  JOBLIB,  link-list,  or  LPA  pointing 
to  old  load  modules,  or  the  database  has  not  been  converted  to  the  correct  release 
level  (new  releases  of  product  may  require  conversion  of  the  database). 

Action:  Either  STEPLIB  to  the  correct  load  modules  or  convert  the  database  to 
the  correct  release  level  (see  VERSION  in  the  SARDBASE  Control  Statements 
section  of  Chapter  7,  "Database  Utilities,"  for  more  information). 


UNLOAD  TAPE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason:  The  imload  tape  referenced  by  the  SARLOAD  DD  statement  is  not 
produced  by  a  compatible  release  level  of  the  SARDBASE  utility. 

Action:  Remove  the  SARLOAD  DD  statement  from  the  restore  execution  JCL,  or 
use  an  unload  tape  from  a  compatible  release  level  of  the  SARDBASE  utility. 


UNLOAD  TAPE  IS  FORMAHED  INCORRECTLY 

Reason:  The  imload  tape  referenced  by  the  SARLOAD  DD  statement  contains 
unrecognizable  data. 

Action:  Remove  the  SARLOAD  DD  statement  from  the  restore  execution  JCL,  or 
specify  a  different  unload  tape. 


NO  BACKUP  COPY  FOR  SYSOUT,  SYSOUT=xxx>ocxxxxxxx, 
GENsxxxx,  SEQ=xxxxx 

Reason:  The  specified  SYSOUT  group  cannot  be  restored  because  the  SYSOUT 
does  not  reside  on  any  backup  tape. 
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Action:  None.  The  status  of  the  SYSOUT  group  remains  unchanged,  and 
processing  continues. 


SYSOUT  NOT  RESTORED  BECAUSE  OF  TAPE  ERROR, 

ID=XXXXXXXXXXXX,  QEH=:XXXXX,  SEQsXXXXX 

Reason:  The  specified  SYSOUT  group  cannot  be  restored  due  to  problems  with 
the  related  backup  tape.  This  message  accompanies  a  SARTPOxx  message 
indicating  the  nature  of  the  error. 

Action:  None.  The  SYSOUT  group  is  removed  from  disk  status  and  processing 
continues.  For  future  use  of  the  SYSOUT  group,  the  backup  tape  may  have  to  be 
recovered.  See  Chapter  8,  "Backing  Up  and  Recovering  the  Database,"  for  more 
information. 


SYSOUT  COULD  NOT  BE  FOUND  ON  BACKUP  TAPE, 
\D=xxxxxxxxxxxx,  GEHsxxxxx,  S£Qt=xxxxx 

Reason:  The  specified  SYSOUT  group  cannot  be  restored  because  the  SYSOUT 
cannot  be  foimd  on  the  related  backup  tape.  This  message  accompanies  a 
SARTPOxx  message  indicating  the  nature  of  the  error. 

Action:  None.  The  SYSOUT  group  is  removed  from  disk  status  and  processing 
continues.  For  future  use  of  the  SYSOUT  group  the  backup  tape  may  have  to  be 
recovered.  See  Chapter  8,  "Backing  Up  and  Recovering  the  Database,"  for  more 
informationi 


SYSOUT  REMOVED  FROM  DISK  STATUS  DUE  TO  TAPE  ERROR, 
\D=xxxxxxxxxxxx,  GEN=xxxxx,  SEQsxxxxx 

Reason:  The  specified  SYSOUT  group  cannot  be  restored  due  to  problems  with 
the  related  backup  tape  and  therefore,  is  being  removed  from  disk  status. 

Action:  None.  The  SYSOUT  group  is  removed  from  disk  status  and  processing 
continues.  For  future  use  of  the  SYSOUT  group  the  backup  tape  may  have  to  be 
recovered.  See  Chapter  8,  "Backing  Up  and  Recovering  the  Database,"  for  more 
informationi 


ERROR  OPENING  FILE  FOR  RESOURCE=xxxxxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  page  layout 
RESOURCE  to  the  database.  This  message  accompaiues  a  SARDBIxx  message 
indicating  the  nature  of  the  error. 
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Action:  See  the  explanation  and  action  of  the  SARDBIxx  message  for  resolution. 

ERROR  WRITING  FILE  FOR  RESOURCE=xxxxxxxxxxx 

Reason:  An  error  occurs  while  attempting  to  restore  the  specified  page  layout 
RESOURCE  to  the  database.  This  message  accompanies  a  SARDBIxx  message 
indicating  the  nature  of  the  error. 

Action:  See  the  explaiiation  and  action  of  the  SARDBBcx  message  for  resolution. 


ERROR  UPDATING  INDEX  RECORD  FOR  RESOURCE=xxxxxxxxxxx 

Reason:  An  error  occisrs  while  attempting  to  restore  the  specified  page  layout 
RESOURCE  to  the  database.  This  message  accompanies  a  SARDBB«  message 
indicating  the  nature  of  the  error. 

Action:  See  the  explanation  and  action  of  the  SARDBbcx  message  for  resolution. 


NO  BACKUP  COPY  FOR  RESOURCE,  IDsxxxxxxxxxxx 

Reason:  The  specified  page  layout  RESOURCE  cannot  be  restored  because  the 
RESOURCE  does  not  reside  on  any  backup  tape. 

Action:  None.  The  status  of  the  RESOURCE  remains  imchanged,  and  processing 
continues. 


RESOURCE  NOT  RESTORED  BECAUSE  OF  TAPE  ERROR, 
ID=xxxxxxxxxxx 

Reason:  The  specified  page  layout  RESOURCE  cannot  be  restored  due  to 
problems  with  the  related  backup  tape.  This  message  accompanies  a  SARTPOXx 
message  indicating  the  nature  of  the  error. 

Action:  None.  The  RESOURCE  is  removed  from  disk  status  and  processing 
continues.  For  future  use  of  the  RESOURCE,  the  backup  tape  may  have  to  be 
recovered.  See  Chapter  8,  "Backing  Up  and  Recovering  the  Database,"  for  more 
information. 
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RESOURCE  COULD  NOT  BE  FOUND  ON  BACKUP  TAPE, 
\D=xxxxxxxxxxx 

Reason:  The  specified  page  layout  RESOURCE  cannot  be  restored  because  the 
SYSOUT  cannot  be  found  on  the  related  backup  tape.  This  message  accompanies 
a  SARTPOxx  message  indicating  the  nature  of  the  error. 

Action:  None.  The  RESOURCE  is  removed  from  disk  status  and  processing 
continues.  For  future  use  of  the  RESOURCE  the  backup  tape  may  have  to  be 
recovered.  See  Chapter  8,  "Backing  Up  and  Recovering  the  Database,"  for  more 
information. 


RESOURCE  REMOVED  FROM  DISK  STATUS  DUE  TO  TAPE  ERROR, 
\D=xxxxxxxxxxx 

Reason:  The  specified  page  layout  RESOURCE  cannot  be  restored  due  to 
problems  with  the  related  backup  tape  and  therefore,  is  being  removed  from  disk 
status. 

Action:  None.  The  RESOURCE  is  removed  from  disk  status  and  processing 
continues.  For  future  use  of  the  RESOURCE  the  backup  tape  may  have  to  be 
recovered.  See  Chapter  8,  "Backing  Up  and  Recovering  the  Database,"  for  more 
information. 


PANEL  RESTORED  FROM  LOAD  TAPE,  PAHEL^xxxxxxxx 

Reason:  The  specified  panel  has  been  successfully  restored  from  the  xmload  tape. 
Action:  None.  This  is  an  informational  message. 


SYSOUT  RESTORED  FROM  LOAD  TAPE,  SYSOUT=xxxxxxxxxxxx, 
GEN=xxxxx,  SEQsxxxxx 

Reason:  The  specified  SYSOUT  group  has  been  successfully  restored  from  the 
unload  tape  and  now  resides  ondisk  media. 

Action:  None.  This  is  an  informational  message. 


SYSOUT  RESTORED  FROM  BACKUP  TAPE, 
SYSOUT=xxxxxxxxxxxx,  GEN=xxxxx,  SEQ=xxxxx 

Reason:  The  specified  SYSOUT  group  has  been  successfully  restored  from  the 
backup  tape  and  now  resides  on  disk  media. 
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Action:  None.  This  is  an  mformational  message. 


SYSOUT  DATA  WAS  NOT  RESTORED  DURING  THE  RECOVERY 
PROCESS  BECAUSE  THERE  WAS  NO  TAPE  ARCHIVAL  OR 
UNLOAD  BACKUP  CONTAINING  THE  SYSOUT 

Reason:  This  message  becomes  the  data  for  the  SYSOUT  attempted  to  be 
restored. 


Action;  None.  If  a  tape  which  contains  the  SYSOUT  can  be  located,  the  SYSOUT 
can  be  reloaded  using  GA-View  utilities. 


RESOURCE  RESTORED  FROM  LOAD  TAPE,  lD=xxxxxxxxxxx 

Reason:  The  specified  page  layout  RESOURCE  has  been  successfully  restored 
from  the  unload  tape  and  now  resides  on  disk  media. 

Action:  None.  This  is  an  informational  message. 


RESOURCE  RESTORED  FROM  BACKUP  TAPE,  ID^xxxxxxxxxxx 

Reason;  The  specified  page  layout  RESOURCE  has  been  successfully  restored 
from  the  backup  tape  and  now  resides  on  disk  media. 

Action:  None.  This  is  an  mformational  message. 


SYSOUT  RESTORE  COMPLETED 

Reason;  This  message  indicates  that  the  restore  process  is  finished  (whether 
successfully  or  not). 

Action:  None.  This  is  an  informational  message. 


******************************************** 
*  * 

*  CA-View  FSS/FSA  (  joibname  /jobid  )  * 

*  PRODUCT  HAS  ABEHDED  WITH  CODE  code  * 

*  *»*  RESTART  PRODUCT  ASAP  ***  * 

*  * 
******************************************** 


Reason:  The  CA-View  FSS  (Frmctional  Subsystem)  or  CA-View  FSA  (Functional 
Subsystem  Application)  has  abended.  The  system  or  user  abend  code  is 
provided. 
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Action:  Consult  the  MVS  System  Codes  manual  to  determine  the  reason  for  the 
abend.  If  you  still  cannot  determine  the  problem^  Contact  Computer  Associates 
Technical  Support. 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP. 

INVALID  bik 

Reason:  A  CA-View  program  has  terminated,  and  a  dump  was  generated.  In  this 
message,  blk  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  IFB,  SFB,  XFB,  or  DBB).  It  may  be  suffixed  with  a  nirmber  indicating 
which  test  point  in  the  program:  detected  the  problem. 

Action:  Send  the  dximp  to  Computer  Associates  Technical  Support.  Restart 
whatever  program  was  terminated.  If  the  problem  recurs,  nm  SAHDBASE 
VERIFY  on  the  database.  If  the  problem  persists,  contact  Computer  Associates 
Technical  Support. 


SYSOUT  ALLOCATION  FAILED.  ERR=xxxx,  INFO=xxxxx 

Reason:  Dynamic  allocation  failed  for  allocating  the  print  data  set  to  SYSOUT. 
The  hexadecimal  error  and  information  codes  are  provided. 

Action:  Correct  the  problem,  then  resubmit  the  job. 


NO  DISTRIBUTION  IDENTIFIERS  FOR  REPORT  -  USE  CA-VIEW  TO 
PRINT  REPORT 

Reason:  Distribution  identifier  has  not  been  specified  for  the  desired  report. 

Action:  Specify  a  Distribution  Identifier  for  the  report  or  enter  the  keyword  SAR 
and  print  through  CA-View  directly. 


NO  SYSOUT  COULD  BE  PRINTED 

Reason:  Problems  are  encoimtered  with  the  CA-Deliver  database  interface,  or 
problems  are  encoimtered  printing  banner  pages  for  reports  in  CA-Deliver. 
Processing  is  terminated. 

Action:  Respond  to  additional  message  which  precedes  this  message. 


THE  TAPE  CONTAINED  A  NULL  FILE  FOR  THE  SYSOUT  GROUP 

Reason:  The  SYSOUT  group  cannot  be  fotmd  on  the  tape  backup. 

;  ) 
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Action:  None.  The  SYSOUT  group  is  not  available  on  tape. 


THE  TAPE  FILE  WAS  NOT  THE  SELECTED  SYSOUT  GROUP  -  USE 
SARTCP  TO  MAP  THE  TAPE 


Reason:  The  SYSOUT  group  located  on  tape  is  not  the  same  as  referenced  in  the 
master  index. 

Action:  Use  the  SARTCP  utility  to  map  and  correct  the  tape. 

BACKUP  TAPE  DOES  NOT  EXIST 


Reason:  The  backup  tape  cannot  be  fotmd  in  the  index  file.  This  is  normally 
caused  by  a  backup  cycle  deleting  the  tape  between  the  time  the  job  was 
submitted  and  the  time  it  was  executed. 

Action:  None.  The  SYSOUT  group  is  no  longer  available. 


TAPE  ALLOC  ERROR  CODE  -  xxxx,  INFO  CODE  -  xxxxxx 

Reason:  D5mamic  allocation  failed  for  the  backup  tape  file.  The  hexadecimal 
error  and  information  codes  are  provided. 

Action:  Correct  the  problem^  then  resubmit  the  job. 


I/O  ERROR  POSITIONING  TAPE 

Reason:  A  permanent  1/ O  error  occurs  while  attempting  to  position  the  archival 
tape  to  retrieve  the  SYSOUT  group. 

Action:  Resubmit  the  job.  If  the  I/O  error  occurs  again,  then  the  desired  SYSOUT 
group  can  no  longer  be  printed. 


SYSOUT  GROUP  IS  OPEN  FOR  OUTPUT 

Reason:  The  requested  function  cannot  be  performed  because  the  specified 
SYSOUT  group  is  open  for  output 

Action:  If  the  open  condition  is  valid  (for  example,  the  SYSOUT  group  is  stiU 
being  archived  or  is  being  loaded  to  disk),  wait  for  the  SYSOUT  group  to  be 
closed  and  rerun  the  job. 
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If  the  open  condition  is  invalid  (for  example,  there  was  a  system  crash  or  abend 
while  the  SYSOUT  group  was  open  leaving  the  SYSOUT  group  in  an  open 
status),  use  the  CLEAN  operator  conunand  to  remove  the  open  status.  Two 
backup  cycles  and  a  duration  of  4  hours  must  have  elapsed  before  the  open  status 
is  removed. 


PERMANENT  I/O  ERROR  ON  INPUT  TAPE 

Reason:  A  permanent  I/O  error  occurs  while  reading  the  SYSOUT  from  tape. 

The  print  function  is  terminated. 

Action;  Use  the  SARTCP  utility  to  map  and  correct  the  tape. 

VIEW  DEFINITION  FOR  REPORT  WAS  NOT  FOUND 

Reason:  The  logical  view  definition  for  the  report  is  not  foimd. 

Action:  Respecify  the  print  request  with  a  new  logical  view. 

i  'i 


message  text  varies 

Reason:  A  subprogram  returned  a  message  which  is  being  repeated  here. 
Action;  Varies  depending  on  the  message  text  displayed. 


THE  OCR  RECORD  WAS  NOT  FOUND  FOR  THE  RESOURCE  GROUP 

Reason:  The  resource  group  identified  by  a  group  control  record  was  not  found 
in  the  GA-View  database. 

Action;  Use  the  SARTCP  utility  to  map  and  locate  the  resource  group  and  use 
the  SARTDR  utility  to  reload  the  resource  group  back  into  the  CA-View  database. 


SYSOUT  QUEUED  FOR  TRANSMIHAL  TO  PC 

Reason:  The  SYSOUT  group  is  successfully  queued  for  PC  transmittal. 
Action:  None.  This  is  an  informational  message. 
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PC  TRANSMIHAL  GUJEUE  FULL  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  PC  transmittal  queue  for  the  user  is  full.  The  SYSOUT  group  cannot 
be  added  to  the  queue. 

Action:  Transmit  and  clear  the  queue. 

PC  DESTINATION  INVALID  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  destination  is  not  of  the  form  PC  user  ID. 

Action:  Correct  the  destination. 

USER  NOT  DEFINED  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  PC  user  is  not  defined  to  CA-View. 

Action:  Correct  the  user  ID  in  the  destination. 


UNABLE  TO  LOAD  VTAM  DEVICE  DRIVER  xxxxxxxx 

Reason:  The  DEFine  DEVice  information  requests  that  output  be  processed  by 
an  optional  device  driver  called  xxxxxxxx,  but  it  cannot  be  formd. 

Action:  Either  make  the  device  driver  available  (perhaps  through  LINKLIST  or 
STEPLIB),  or  remove  it  from  the  DEFine  DEVice. 


VTAM  MAXIMUM  PRINT  LINES  WAS  EXCEEDED 

Reason:  Your  print  request  exceeds  the  maximum  number  of  lines  permitted 
during  online  VTAM  print  processing. 

Action:  Do  one  of  the  following: 

■  Print  in  smaller  segments. 

■  Increase  the  maximum  permitted  for  this  device  by  using  the  DEFine  DEVice 
facility. 

■  Increase  the  maximum  permitted  for  all  devices  by  using  SARINIT 
parameter  VPRTMAXO; 
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NOT  PRINTED  DUE  TO  ERRORS  ON  OTHER  DESTINATIONS 

Reason:  There  are  no  problems  printing  to  this  destination,  but  an  error  occurs 
while  printing  to  another  destination  in  your  reprint  request. 

Action:  Do  one  of  the  following: 

■  Correct  the  other  error  and  retry. 

■  Make  multiple  separate  print  requests. 


INVALID  DEFINE  DEVICE  RECORD 

Reason:  The  DEFine  DEVice  record  is  invahd.  This  can  be  caused  by  a  record 
which  is  not  completely  defined. 

Action:  Correct  the  DEFine  DEVice  record  and  retry. 


DUPLICATE  VTAM  PRINTER  ID,  VUsxxxxxxxx 

Reason:  You  are  attempting  to  print  more  than  one  SYSOUT  or  report  on  the 
same  VTAM  printer  at  the  same  time.  This  cannot  be  done. 

Action:  Either  use  more  than  one  printer  or  make  more  than  one  print  request  to 
the  printer  in  question. 


CMASPOOL  MAXIMUM  PRINT  LINES  WAS  EXCEEDED 

Reason:  Your  print  request  exceeds  the  maximum  number  of  lines  permitted 
during  CA-Spool  print  processing. 

Action:  Do  one  of  the  following: 

■  Print  in  smaller  segments. 

■  Increase  the  maximum  permitted  for  this  device  by  using  the  DEFine  DEVice 
facility. 

■  Increase  the  maximum  permitted  for  CA-Spool  devices  by  using  SARINIT 
parameter  CMAMAX. 


UNABLE  TO  LOAD  DEVICE’S  USER  EXITxxxxxxxx 

Reason:  The  DEFine  DEVice  information  requests  that  the  output  be  processed 
by  an  optional  device-specific  user  exit  called  xxxxxxxx,  but  it  cannot  be  found. 
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Action:  Either  make  the  device  driver  available  (perhaps  through  LINKLIST  or 
STEPLIB);  or  remove  it  from  the  DEFine  DEVice. 


SYSOUT  QUEUED  FOR  EXTERNAL  PRINTING 

Reason:  The  external  print  request  was  successfully  queued  for  processing. 
Action:  None.  This  is  an  informational  message. 


ALLOCATION  FAILED  FOR  ARCHIVAL  SYSOUT  -  ERROR  xxxx, 
INFO  xxxx 

Reason:  A  dynamic  allocation  request  for  allocating  the  archival  copy  for  the 
automatic  report  archival  feature  failed.  The  hexadecimal  error  and  information 
codes  are  provided.  Execution  continues  without  creating  the  archival  copy  of  the 
SYSOUT — ^no  archival' of  die  SYSOUT  is  done. 


Action:  Correct  the  parameter  information  for  the  automatic  report  archival 
feature. 

OPEN  FAILED  FOR  ARCHIVAL  SYSOUT  -  ERROR  xx 

Reason:  The  open  request  failed  for  the  archival  copy  for  the  automatic  report 
archival  feature. 

Action:  Correct  the  problem  with  open. 


CA-VIEW  2.0  IS  INITIALIZED 

Reason:  Initialization  has  completed  for  the  archival  task. 
Action:  None.  This  is  an  informational  message. 


SUBSYSTEM  REQUEST  FAILED  -  RETURN  CODE  xxxxxxxx 

Reason:  A  subsystem  request  failed.  The  hexadecimal  return  code  is  provided. 
Action:  Contact  your  systems  programmer. 
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SARSTCIO 


PROCESS  SYSOUT  REQUEST  FAILED  -  RETURN  CODE  xxxxxxxx 

Reason:  A  process  SYSOUT  request  failed  for  the  subsystem.  The  hexadecimal 
return  code  is  provided. 

Note:  A  return  code  of  X'lC'  indicates  an  invalid  destination.  Verify  that  the 
destination  specified  with  the  DEST  initialization  option  is  known  to  JES. 

Action:  Contact  your  systems  programmer. 


SUBSYSTEM  ALLOCATION  FAILED  ERROR  CODE  -  xxxx,  INFO 
CODE  -  xxxx,  JOB  job(/ob/G0,  DATASET  datasetname 

Reason:  Dynamic  allocation  failed  for  the  process  SYSOUT  data  set.  The 
hexadecimal  error  and  information  codes  are  provided. 

Action:  Contact  your  systems  programmer. 


SUBSYSTEM  OPEN  REQUEST  FAILED  -  ERROR  CODE  xx,  JOB 
jobijobid),  DATASET  dsname 

Reason:  A  subsystem  open  request  failed.  The  hexadecimal  error  code  is 
provided. 

Action:  Contact  your  systems  programmer. 


AHEMPT  TO  ARCHIVE  SYSOUT  FROM  ARCHIVAL  TASK 

Reason:  The  jobname  of  the  SYSOUT  passed  to  CA-View  for  archival  is  the  same 
as  the  archival  started  task,  and  the  producing  DDname  is  SYSnnn.  To  prevent  a 
potential  archival-print  loop,  CA-View  deletes  the  SYSOUT  without  ever 
archiving  it. 

Action:  Correct  or  specify  the  NEWCLSL,  NEWDEST,  or  NEWFORM  options  to 
prevent  the  archival  of  SYSOUT  automatically  printing  the  archival  started  task. 


SUBSYSTEM  GET  REQUBT  FAILED  -  RPL  FEEDBACK  xxxxxx 

Reason:  A  subsystem  GET  request  failed.  The  hexadecimal  feedback  code  is 
provided.  This  is  normally  due  to  a  system  crash  while  the  job  that  created  the 
data  set  was  executing.. 

Action:  None.  This  is  an  informational  message. 
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SARSTC14 


SARSTC15 


SARSTC16 


SARSTC17 


SARSTC19 


SARSTC21 


ESTAE  FAILED  -  RETURN  CODE  xxxxxxxx 

Reason:  An  ESTAE  failed^  The  hexadecimal  return  code  is  provided. 
Action:  Contact  your  systems  progranuner. 

INVALID  COMMAND 

Reason:  The  modify  command  for  the  archival  started  task  is  invalid  and 
ignored. 

Action:  Correct  and  reissue  the  modify  command. 


SARSTC  IS  NOT  A  STARTED  TASK 

Reason:  An  attempt  has  been  made  to  execute  SARSTC  as  other  than  a  started 
task. 

Action:  Execute  SARSTC  by  using  the  START  command. 


SYSOUT  ALLOCATION  FAILED  -  ERROR  CODE  xxxx,  INFO  CODE 
xxxx 

Reason:  A  dynamic  allocation  request  for  allocating  the  print  data  set  to  SYSOUT 
failed.  The  hexadecimal  error  and  information  codes  are  provided.  Execution 
continues  without  printing  the  SYSOUT  for  the  job. 

Action:  Determine  the  reason  for  the  failure  and  correct  the  problem; 


DATABASE  IS  ALREADY  EXCLUSIVELY  BEING  USED 

Reason:  Another  archival  task  with  the  same  database  is  already  executing. 
Action:  Correct  the  problem; 


VERIFY  SARSTC  NOT  ACTIVE  ON  SYSTEM  xxxx,  REPLY  Y/N  TO 
CONTINUE 

Reason:  The  master  index  indicates  that  the  archival  task  is  already  active  on 
system  xxxx.  This  message  may  also  be  issued  if  the  archival  task  abended  or  the 
system  crashed  the  last  time  the  archival  task  was  active. 
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SARSTC22 


SARSTC23 


SARSTC24 


Action:  Verify  whether  or  not  the  archival  task  is  actually  active  on  the  specified  \ _ / 

system.  If  it  is,  reply  N  to  terminate  this  task;  if  not,  reply  Y  to  continue. 


Warning!;  Never  run  the  ai'duval  task  fur  Iho  same  index  hit  on  more  than 
one  system  at  the  .same  time;  this  can  de.stro\  the  master  index. 


PROCESSING  Jobname/dsname 

Reason:  The  specified  SYSOUT  data  set  is  being  processed  by  CA-View. 
Action:  None.  This  is  an  informational  message. 


MAXIMUM  LINES  EXCEEDED  FOR  iob(Jobid) 

Reason:  The  maximum  number  of  lines  that  can  be  archived  for  a  SYSOUT  data 
set  (defined  by  the  MAXLINES  initialization  parameter)  has  been  exceeded.  If 
BYPASS  has  been  coded  as  a  subparameter  of  MAXLINES,  aU  remaining 
SYSOUTs  for  the  data  set  are  deleted  without  archival.  If  BYPASS  is  not  coded, 
the  records  are  passed  to  SARSTCUX  for  processing. 

Action:  None.  This  is  an  informational  message. 

u 

NO  MORE  SPACE  IN  DATABASE  -  REPLY  R  (RETRY),  B  (BACKUP), 

C  (CLEAN),  OR  T  TERMINATE 

Reason:  The  database  is  out  of  space. 

Action:  You  have  four  recovery  options,  as  follows: 

■  Run  the  SARDBASE  program  to  add  more  space  to  the  database,  or  manually 
delete  SYSOUT  groups  to  free  up  space  while  the  archival  task  waits.  After 
you  make  more  space  available,  reply  R  to  have  the  archival  task  retry  its 
archival  with  the  additional  space. 

■  Reply  B  to  force  the  archival  task  to  execute  its  backup  cycle.  As  part  of  its 
backup  cycle,  the  archival  task  deletes  the  generation  of  SYSOUT  on  disk  that 
is  in  excess  of  the  NGEND=  initialization  parameter,  freeing  some  space. 

■  Reply  C  to  force  the  archival  task  to  scan  its  database  for  SYSOUT  groups  left 
in  an  open  state  due  to  a  system  crash  and  recover  the  space  used  by  them. 

■  Reply  T  to  terminate  the  archival  task. 


1 2-1 86  CA-View  System  Reference  Guide 


Diagnostic  and  Error  Messages 


SARSTC25 


SARSTC26 


SARSTC27 


SARSTC28 


SARSTC29 


DATABASE  AT  INCORRECT  LEVEL  FOR  THIS  RELEASE 

Reason;  The  program  load  modules  and  the  database  are  not  the  same  release 
level.  CA-View  does  not  execute. 

Action;  Correct  the  problem  and  retry. 


NO  RESPONSE  FROM  JES(2/3)  IN  nn  MINUTES 

Reason:  This  is  an  inf ormational  message.  Informs  a  user  that  CA-View  is 
operative,  though  JES  has  not  had  any  outputs  in  the  queue  within  the 
predefined  5  minute  time  span* 

Action:  None.  This  is  an  informational  message. 


I/O  ERROR  WRITING  PAGE  INDEX  FOR  SYSOUT  -  PAGE  INDEX 
DELETED 

Reason:  An  I/O  error  occurs  while  writing  out  the  index  data  for  the  SYSOUT 
group.  Any  index  data  already  written  is  deleted. 

Action:  Correct  the  error  with  the  database. 


SARSTC  REQUIRES  APF  AUTHORIZATION 


Reason;  CA>-View  initialization  failed  because  program  authorization  via  the 
Authorized  Program  Facility  (APF)  is  required. 

Action:  APF  authorize  the  libraries  containing  the  CA-View  load  modules  or 
move  the  load  modules  to  an  authorized  library. 


FORWARD  RECOVB5Y  TERMINATED  DUE  TO  ERROR 

Reason;  The  SARSTC  archival  task  has  encountered  an  error  in  the  process  of 
writing  a  duplex  copy  of  a  SYSOUT  to  the  forward  recovery  data  set. 

Action:  Archival  continues  without  forward  recovery  capture.  Check  the 
RCVPRIM,  RCVSEC,  RCVSPACE,  and  RCVUNIT  initialization  parameters  for 
values  that  could  cause  problems  allocating,  reading,  or  writing  to  the  forward 
recovery  data  set. 
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SARSTC30 


SARSTC31 


SARSTC32 


SARSTC33 


SARSTC37 


**************************************************** 
*  * 

*  SARSTC  HAS  ABEKDED  WITH  CGDB  xaaac  * 

*  * 
******************  ***************  ******************* 


Reason:  The  CA-View  started  task  has  abended.  The  system  or  user  abend  code 
is  provided. 

Action:  Consult  the  MVS  System  Codes  manual  to  determine  the  reason  for  the 
abend.  If  you  still  cannot  determine  the  problem,  contact  Computer  Associates 
Technical  Support. 


PC  TRANSMIHAL  QUEUE  FULL  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  PC  transmittal  queue  is  full  for  the  user.  The  SYSOUT  group  will 
not  be  queued  for  transmittal  to  tiie  PC. 

Action:  Have  the  user  transmit  the  queue  and  clear  the  entries. 


PC  DESTINATION  INVALID  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  destination  specified  must  be  of  the  format  PC.user  ID. 
Action:  Correct  the  destination. 


USER  NOT  DEFINED  -  SYSOUT  NOT  QUEUED  TO  PC 

Reason:  The  user  ID  specified  in  the  destination  is  not  defined  to  CA-View. 
Action:  Correct  the  destination  or  define  the  user  ID  to  CA-View. 

MAXIMUM  LINES  EXCEEDED  FOR  SYSOUT  ON  VTAM  PRINTER 

Reason:  Your  print  request  exceeded  the  maximum  number  of  lines  permitted 
during  VTAM  print  processing.  This  message  can  also  occur  onnon-VTAM 
printers  as  an  indication  that  an  error  occurred  while  printing  on  both  devices 
simultaneously. 

Action:  Increase  the  maximum  permitted  for  this  device  by  using  the  DEFine 
DEVice  facility  or  increase  the  maximum  permitted  for  all  devices  by  using 
SARINn'  parameter  VPRTMAXO. 
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SARSTC38 


SARSTC39 


SARSTC40 


SARSTC99 


SARTCPOl 
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MAXIMUM  LINES  EXCEEDED  FOR  SYSOUT  ON  CMASPOOL 

Reason:  Your  printi  request  exceeded  the  maximum  number  of  lines  permitted 
during  online  GA-Spool  priht  processing.  This  message  can  also  occur  on  non- 
VTAM  printers  as  an  indication  that  an  error  occurred  while  printing  on  both 
devices  simultaneously. 

Action:  Increase  the  maximum  permitted  for  this  device  by  using  the  DEEine 
DEVice  facility  or  increase  the  maximum  permitted  for  CA-Spool  devices  by 
using  SARINIT  parameter  CMAMAX. 


ERROR  IN  DEFINE  DEVICE  RECORD  FOR  SYSOUT 

Reason:  The  device  record  is  invalid.  This  could  be  caused  by  a  record  which 
was  not  completely  defined. 

Action:  Correct  the  device  record  by  using  the  DEFine  DEVice  facility. 

UNEXPECTED  RETURN  CODE  PRINTING  SYSOUT  id  OH  dest 
RC= code 

Reason:  An  xmknown  return  code  was  detected  in  response  to  a  print  request. 
Action:  Contact  Computer  Associates  Technical  Support. 


jobid  jobname  m^sage 

Reason:  An  exceptional  condition  identified  by  message  occurs  for  the  specified 
job. 

Action:  Take  appropriate  action. 


CONTROL  CARD  Era?OR 

Reason:  There  is  an  error  in  the  specified  control  statement. 
Action:  Correct  the  control  statement,  then  resubmit  the  job. 
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SARTCPIO 


SARTCPl  1 


SARTCP12 


SARTCPl  6 


SARTDROO 


SARTDR01 


INPUT  TAPE  I/O  ERROR,  ECB=xx,  BLOCKsxxxxxxx, 
SENSE=xxxx SARTCPIO  ENTER  Y/N  TO  DROP  BLOCK  AND 
CONTINUE 

Reason:  A  permanent  I/O  error  occurs  while  reading  the  specified  block  from 
the  input  tape.  The  ECB  and  SENSE  codes  are  provided. 

Action:  Reply  Y  to  skip  the  bad  block  and  continue,  or  N  to  terminate  the  job. 


OUTPUT  TAPE  I/O  ERROR,  ECB=xx,  BLOCK=xxxxxxx,  SENSE=xxxx 

Reason:  A  permanent  I/O  error  occurs  while  writing  the  specified  block  to  the 
output  tape. 

Action:  Resubmit  the  job  using  a  different  output  tape. 


WRITE  TAPE  MARK  I/O  ERROR,  ECB=xx,  SENSE=xxxx 

Reason:  A  permanent  1/ O  error  occurs  while  writing  a  tape  mark  on  the  output 
tape. 

Action:  Resubmit  the  job  using  a  different  output  tape. 


PROCESSING  SUCCESSFULLY  COMPLETED 

Reason:  Processing  has  been  successfully  performed. 
Action:  None.  This  is  an  informational  message. 


REPLY  Y/N  TO  AUTHORIZE  EXECUTION  OF  SARTDR 

Reason:  The  operator  must  authorize  the  execution  of  SARTDR. 

Action:  Reply  Y  to  authorize  the  execution  of  SARTDR,  or  N  to  cancel  the 
execution  of  SARTDR. 


INVALID  REPLY 

Reason:  The  console  reply  to  the  SARTDROO  message  is  invalid. 

Action:  When  the  SARTDROO  message  is  reissued,  reply  Y  to  authorize  the 
execution  of  SARTDR>  or  N  to  cancel  the  execution  of  SARTDR. 
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SARTDR02 


SARTDR03 


SARTDR04 


SARTDRQ5 


TAPE  SEQUENCE  NUMBER  DOES  NOT  MATCH  THAT  OF  SYSOUT 
GROUP  xxxxxxxx  RECORDED=nnnnn  ACTUAL=nnnnn 
TAPE  SEQUENCE  NUMBER  DOES  NOT  MATCH  THAT  OF 
RESOURCE  xxxxxxxx  RECORDED=/7nnnn  ACTUAL=nnnnn 

Reason:  The  actual  tape  sequence  number  obtained  from  the  data  set  name  for 
the  tape  does  not  match  ttiat  recorded  with  the  SYSOUT  group  or  page  layout 
RESOURCE  that  is  being  added.  The  SYSOUT  group  or  RESOURCE  is  not 
added: 

Action:  Verify  the  data  set  name  for  the  tape. 


SYNTAX  ERROR 

Reason:  The  specified  control  statement  contains  an  error  in  its  syntax. 
Action:  Correct  the  statement,  then  resubmit  the  job. 


This  message  number  represents  one  of  the  following  messages: 

POSITION  OF  SYSOUT  GROUP  xxxxxxxx  INVALID 
RECORDEDs/innnn  ACTUALsnnnnn 

POSITION  OF  RESOURCE  xxxxxxxx  INVALID  RECORDED=n/jnnn 
ACTUALsnnnnn 

Reason:  The  actual  position  of  the  SYSOUT  group  or  page  layout  RESOURCE  on 
the  tape  does  not  match  that  recorded  with  it.  The  SYSOUT  group  or  RESOURCE 
is  not  added. 

Action:  USE  SARTCP  to  correct  the  problem  with  the  tape. 


I/O  ERROR  POSITIONING  TAPE 

Reason:  A  permanent  I/O  error  occurs  while  attempting  to  position  the  archival 
tape  to  retrieve  the  SYSOUT  group. 

Action:  Salvage  the  data  on  the  tape  using  the  SARTCP  utility,  then  resubmit  the 
job. 
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SARTDR06 


SARTDR07 


SARTDR08 


SARTDR09 


SARTDRIO 


TAPES  NOT  ADDED  IN  ORDER  FOR  SYSOUT  GROUP  xxxxxxxx 
GENsnnnnn  SEQsnnnnn 

TAPES  NOT  ADDED  IN  ORDER  FOR  RESOURCE  xxxxxxxx 

Reason;  A  multi-tape  SYSOUT  group  or  page  layout  RESOURCE  is  being  added 
but  the  tapes  for  it  have  not  been  added  in  ascending  order. 

Action:  Re-add  the  tapes  for  the  SYSOUT  group  or  RESOURCE  in  ascending 
order. 


AUTHORIZATION  DENIED  BY  OPERATOR 

Reason:  The  operator  replies  N  to  message  SARTDROO. 

Action:  Obtain  authority  to  run  SARTDR  from  the  operator,  then  resubmit  the 
job; 


TAPE  DD  STATEMENT  NOT  FOUND 

Reason:  The  DD  statement  for  the  tape  cannot  be  found; 

Action:  Add  the  DD  statement  to  the  JCL,  then  resubmit  the  job. 


INVALID  TAPE  DATASET  NAME 

Reason:  The  data  set  name  for  tire  tape  to  be  added  does  not  conform  to  the 
naming  conventions  for  archival  tapes. 

Action:  Correct  the  problem,  then  resubmit  the  job. 


CURRENT  GENERATION  SET  TO  nnnnn 

Reason:  The  addition  of  the  tape  requires  the  current  generation  number  to  be 
reset. 

Action:  None.  This  is  an  informational  message. 
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SARTDRl  1 


SARTDR14 


SARTDRl  9 


SARTDR23 


SARTDR24 


TAPE  ADDED  -  dsname  SEQi=nnnnn  LGEN=nnnn/j  HGEN=nn/7nn 
IMsnnnnn 

Reason:  The  specified  archival  tape  is  successfully  added  to  the  master  index 
file.  The  tape  sequence  number,  low  generation  number,  high  generation 
number,  and  number  of  tape  marks  are  given  in  the  message. 

Action:  None.  This  is  an  informational  message. 


TAPE  ERROR  PROCESSING  SYSOUT  GROUP  xxxxxxxx 

GEN=nnnnn  SEQ=nnnnn 

TAPE  ERROR  PROCESSING  RESOURCE  xxxxxxxx 

Reason:  An  error  occurs  when  loading  the  SYSOUT  group  or  page  layout 
RESOURCE  from  tape. 

Action:  Consult  the  associated  tape  error  message  written  to  the  job  log  for  the 
appropriate  action: 


TAPE  LOAD  SUCCESSFULLY  PERFORMED 

Reason:  The  specified  generation  has  been  successfully  reloaded  to  disk. 
Action:  None.  This  is  an  informational  message. 

SYSOUT  GROUP  xxxxxxxx  LOADED  TO  DISK  GEN=nnnnn 
SEQ-nnn  RESOURCE  xxxxxxxx  LOADED  TO  DISK 

Reason:  The  specified  SYSOUT  group  or  page  layout  RESOURCE  has  been 
successfully  loaded  to  disk. 

Action:  None.  This  is  an  informational  message. 

DATABASE  IS  ALREADY  IN  USE 

Reason;  Another  archival  task  with  the  same  database  is  already  executing. 
Action;  Correct  the  problem: 
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SARTDR26 


SARTDR49 


SARTIAOl 


SARTIA02 


SARTIA03 


SPECIFIED  GENERATION  DOES  NOT  EXIST 

Reason:  The  master  index  does  not  contain  any  SYSOUT  groups  for  the 
generation  specified  on  the  TLOAD  control  statement. 

Action:  SYSOUT  groups  must  be  previously  added  to  the  master  index  by  using 
the  TADD  control  statement.  If  an  invalid  generation  was  specified,  correct 
specification,  then  resubmit  the  job. 


PERMANENT  I/O  ERROR  READING  TAPE 

Reason:  An  I/O  error  occurs  while  loading  a  SYSOUT  group  to  disk. 

Action:  Salvage  the  data  on  the  tape  using  the  SARTCP  utility,  then  resubmit  the 
job. 


EXPANDED  ACCESS  TAPE  SERVER  IS  NOT  ACTIVE 

Reason:  TAPEOPT=EAST  for  the  VIEW  database  and  the  SAREAS  server  whose 
name  appears  in  the  EASTNAME  parameter  is  not  active. 

Action:  See  your  system  administrator  to  determine  why  SAREAS  is  not  active. 
Generally,  VIEW  will  attempt  to  directly  mount  the  volume  containing  the 
report. 


EXPANDED  ACCESS  PRIMARY  TAPE  SERVER  IS  NOT  ACTIVE 

Reason;  The  primary  server  (responsible  for  moimting  voliimes  and  performing 
I/O)  is  not  active. 

Action:  See  your  system  administrator  to  determine  why  SAREAS  is  not  active. 
Generally,  VIEW  will  attempt  to  directly  mount  the  volume  containing  the 
report. 


EXPANDED  ACCESS  TAPE  SERVER  ABENDED 

Reason:  The  server  has  abended  while  the  user's  request  was  outstanding. 

Action:  Collect  the  appropriate  information  for  problem  analysis,  then  see  your 
system  administrator  to  restart  the  server. 
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SARTIA05 


SARTIA06 


SARTIA07 


SARTIA08 


SARTIA09 


EASTMAXW  TIMEOUT  EXCEEDED  -  RETRY  LATER 


Reason:  An  attempt  was  made  to  view  a  report  directly  from  tape,  using  the 
Expanded  Access  ^rver.  The  EASTMAXW  parameter,  which  specifies  a  time-out 
time,  was  exceeded. 

Action:  Retry  later. 


UNABLE  TO  LOCATE  PAGE  RECORD  VECTOR 

Reason:  You  are  viewing  a  tape  report,  and  the  Expanded  Access  Server  was 
imable  to  locate  a  page  record  vector. 

Action:  See  your  system  administrator.  Each  report's  page  record  vector  is 
located  via  a  field  in  the  GCR  in  the  DASD  database.  The  tape  may  have  been 
damaged.  The  system  administrator  may  be  successful  in  running  SARPAC  on 
just  the  volume  containing  the  report,  after  which  you  should  be  able  to  access  it. 

NO  ACCESS  UNDER  VM/CMS,  RELOAD  SYSOUT  GROUP  TO 
DATA  BASE 

Reason:  An  attempt  was  made  to  view  a  report  in  tape  via  the  Expanded  Access 
Server  under  VM/CMS.  The  server  is  not  supported  imder  VM/CMS. 

Action:  Access  the  report  from  another  CA-View  online  interface,  or  reload  the 
report  to  DASD. 


END  OF  DATA 

Reason:  A  report  on  tape  was  being  viewed  via  the  expanded  access  server.  The 
END  OF  DATA  was  unexpectedly  reached. 

Action:  See  your  system  administrator  about  running  SARFAC  on  the  volume 
containing  the  report.  The  report's  mapping  information  may  have  been 
overwritten.  SARPAC  will  write  new  mapping  information  for  each  report  on  the 
tape. 


SYSOUT  GROUP  IS  NOT  ON  EXPANDED  ACCESS  TAPE 

Reason:  An  attempt  was  made  to  view  a  report  on  a  tape  that  was  not  created 
with  TAPEOPT=EAST  or  TAPEOPT=3480. 

Action:  See  your  system  administrator  about  running  SARPAC  on  the  volume 
containing  the  report. 
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SARTIA1 1 


SARTIA20 


SARTIA30 


SARTIA40 


LOGICAL  I/O  ERROR  ON  TAPE 

Reason:  An  attempt  was  made  to  view  a  report  on  tape  via  the  expanded  access 
server,  and  an  I/O  error  was  encoimtered. 

Action:  See  your  system  administrator  about  running  SARPAC  on  the  volume  . 
containing  the  report. 


TAPE  VOLUME  NOT  FOUND 

Reason:  A  dynamic  allocation  error  or  an  open  error  occurred  in  an  attempt  to 
access  the  tape. 

Action:  See  your  system  administrator  to  determine  the  reason  that  the  tape 
cannot  be  foimd  or  accessed.  The  system  log  of  the  SAREAS  server  will  give 
d5nnamic  allocation  return  codes  for  problem  analysis. 


REPORT  SPANS  MORE  THAN  16  VOLUMES 

Reason:  An  attempt  was  made  to  view  a  report  on  tape  via  the  Expanded  Access 
Server,  and  the  report  spans  more  than  16  tapes. 

Action:  SAREAS  can  accommodate  reports  spanning  16  or  fewer  volumes.  The 
report  is  not  viewable  unless  client  services  can  create  an  optional  zap.  The  entire 
page  record  vector  is  read  in  before  the  report  can  be  accessed,  so  response  time 
could  have  been  extremely  slow  and  memory  requirements  in  a  multi-user 
environment  may  have  been  prohibitive. 

If  software  compression  was  notin  effect  when  the  report  was  written  to  tape,  the 
system  administrator  could  set  tive  SOFT  option  of  the  TAPEOPT  parm  and 
SARPAC  the  volumes  containing  the  report,  and  the  user  could  try  accessing  the 
report  again. 


NO  DIRECT  ACCESS  OF  THIS  UNIT  ALLOWED 

Reason:  None  of  the  EASTNAMx  parameters  currently  specifies  the  unit 
containing  the  report.  That  is,  the  report  is  on  a  tape  volume  for  which  no  server 
has  been  defined. 

Action:  Retry  the  access.  The  device  should  be  requested  directly  without  the 
server.  Alternatively,  ask  the  CA-View  administrator  to  define  a  server  for  the 
unit. 
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SARTPI41 


SARTPI42 


SARTPI43 


SARTPI44 


SARTPI46 


TAPE  OPEN  FAILED 

Reason:  The  OPEN  of  the  tape  data  set  failed,  though  the  dynamic  allocation 
succeeded; 

Action:  An  attempt  will  be  made  to  switch  to  the  duplex.  Map  the  original  tape 
using  SARTCP  to  determine  the  error  if  no  security  problems  or  other  obvious 
errors  exist. 


TAPE  ALLOCATION  ERR=x>cxx  DSN=xxxxxxxx 

Reason:  Dynamic  allocation  has  failed  for  the  archival  tape.  The  hexadecimal 
error  and  information  codes  are  provided.  Recovery  is  attempted  by  switching  to 
the  duplex/primary  tape. 

Action:  If  recovery  is  unsuccessful,  correct  the  problem  with  the  tape. 


I/O  ERROR  POSITIONING  TAPE 

Reason:  A  permanent  I/O  error  occurs  while  attempting  to  position  the  archival 
tape.  Recovery  is  attempted  by  switching  to  the  duplex /primary  tape. 

Action:  Use  SARTCP  to  correct  the  problem  with  the  tape. 


mt  TAPE  DOES  NOT  EXIST  OR  DOES  NOT  CONTAIN  FILE-TSQ=nnn 

Reason:  The  PRIMARY  or  DUPLEX  tape  entry  is  not  found  in  the  database  for 
the  SYSOUT  group.  The  tape  sequence  number  is  provided.  Recovery  is 
attempted  by  switching  to  the  duplex /primary  tape. 

Action:  Use  SARTDR  to  add  the  tape  back  to  the  database. 


NULL  FILE  LOCATED 

Reason:  The  file  for  the  requested  SYSOUT  group  is  empty.  This  is  most  likely 
caused  by  a  tape  recovery  using  SARTCP.  An  attempt  is  made  to  switch  to  the 
duplex/ primary  tape. 

Action:  None.  If  recovery  was  unsuccessful,  then  no  data  is  available. 
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SARTPI46 


SARTPI47 


SARTPI48 


SARTP042 


SARTP043 


PERMANENT  i/O  ERROR  ON  TAPE 

Reason;  A  permanent  I/O  error  occurs  when  reading  the  tape.  Recovery  is 
attempted  by  switching  to  the  duplex/primary  tape. 


Action:  Use  SARTCP  to  correct  the  problem  with  the  tape. 


TAPE  SWITCH  IS  BEING  AHEMPTED 

Reason:  In  order  to  recover  from  an  error  with  the  archival  tape,  a  switch  to  the 
duplex/ primary  tape  is  being  made. 

Action:  None.  If  you  do  not  want  the  switch  to  occur,  you  can  reply  NO  to  the 
tape  moimt  message. 


INVALID  HEADER  LOCATED  FOR  FILE 

Reason:  When  positioning  the  archival  tape,  an  invalid  header  record  is  found. 
Recovery  is  attempted  by  switching  to  the  duplex  tape. 

Action:  Use  SARTCP  to  correct  the  problem  with  the  tape. 


TAPE  ALLOCATION  ERROR  CODE  -  xxxx,  INFO  CODE  =  xxxx 
DSNAME  -xxxxxxxx 

REPLY  Y/N  TO  CONTINUE  PROCESSING  WITH  NEW  TAPE 

Reason:  Dynamic  allocation  has  failed  for  the  backup  tape.  The  hexadecimal 
error  and  information  codes  are  provided. 

Action:  Reply  Y  to  the  message  to  allocate  a  new  tape  and  continue  processing. 
Otherwise  reply  N,  correct  the  problem  with  the  tape,  and  restart  the  function. 


I/O  ERROR  FORWARD  SPACING  TAPE  -  NEW  TAPE  VOLUME 
FORCED 

Reason;  A  permanent  I/O  error  occurs  when  attempting  to  forward  space  the 
archival  tape.  A  new  tape  volume  is  used  and  execution  continues. 

Action;  None.  This  is  an  informational  message. 
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CATALOG  ERROR  ON  BACKUP  TAPE  -  DSN=xxxxxxxx,RC=:nn.n/7 

Reason:  An  error  occurs  when  attempting  to  catalog  the  archival  tape.  The  data 
set  name,  the  return  code,  and  reason  code  from  catalog  management  are 
provided. 

Action:  Correct  the  problem  with  the  catalog  structure. 


DUPLEX  TAPE  NOT  COMPATIBLE  WITH  PRIMARY  TAPE  -  NEW  TAPE 
VOLUME  FORCED 

Reason:  A  primary  tape  with  archival  data  normally  appends  with  more  archival 
data,  however;  tape  duplexing  has  been  requested.  Since  the  primary  and  duplex 
tape  volumes  must  be  exact  copies  of  each  other,  a  new  primary  tape  is  forced. 

Action:  None.  This  is  an  mformational  message. 


dsname  ALREADY  EXISTS  -  NEW  TAPE  VOLUME  FORCED 

Reason:  Allocation  of  a  new  backup  tape  is  being  attempted  for  the  specified 
dsname,  but  the  dsname  is  already  cataloged  to  the  system. 

Action:  None.  A  new  tape  volume  and  dsname  are  used. 


UNABLE  TO  OBTAIN  DEVICE  NAME  FOR  unit 

Reason:  The  device  cheiracteristics  for  the  specified  unit  are  not  available  by 
using  the  DEVTYPE  system  service.  Recovery  is  attempted  by  switching  to  the 
duplex  tape. 

Action:  Normally,  this  condition  is  caused  by  an  invalid  device  name  as 
specified  by  the  UNITT  initialization  parameter.  Otherwise,  consult  your  systems 
programming  group  to  determine  why  the  DEVTYPE  system  service  cannot  be 
performed  against  the  unit. 


PERMANENT  I/O  ERROR  WRITING  BACKUP  TAPE  -  NEW  TAPE 
FORCED 

Reason;  A  permanent  I/O  error  occurs  while  writing  to  the  archival  tape.  A  new 
tape  volume  is  used  and  execution  continues. 

Action:  None.  This  is  an  informational  message. 
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SARTP054 


SARTP055 


SARTP056 


SARTP057 


SARTP058 


TAPE  TO  BE  MOUNTED  NEEDS  FILE  PROTECT  RING  IN 

Reason:  The  archival  tape  to  be  mounted  is  written  on  and  requires  its  file 
protect  ring  to  be  left  in. 

Action:  Verify  that  the  tape  to  be  mounted  has  its  file  protect  ring  in. 


SECONDARY  DISK  DOES  NOT  EMULATE  3480  TAPES 

Reason:  The  DSK2P ARM  specifies  a  unit  which  is  not  a  tape  device. 

Action:  Correct  the  DSK2DRVR  name  to  use  the  correct  driver  if  it  is  in  error, 
correct  the  DSK2PARM  to  use  a  tape  device,  or  correct  the  tape  unit's  system 
definition. 


IMMEDIATE  TAPE  ACCESS  REQUIRES  3480  TAPES 

Reason:  The  TAPEOPT  parameter  specifies  EAST,  but  the  tape  unit  does  not 
support  block  ID  processing. 

Action:  Correct  the  tape  imitname  in  the  STORGRPx  definition,  correct  the  tape 
unit's  system  definition,  or  change  TAPEOPT  to  use  3420  processing. 

VOLSER  RANGE  xxxxxx-xxxxxx  EXCEEDED  (VOLSER  RANGE 
MUST  BE  EXTENDED  OR  CHANGED),  PROCESSING  TERMINATED 

Reason:  CA-View  needs  to  create  a  new  tape  volume,  but  the  specified  range  has 
been  exhausted. 

Action:  Define  new  volumes  and  modify  the  range  in  the  STORGRPx  or 
STORGRXx  parameter. 


MAXBLKS  FOR  STORAGE  GROUP  SET  TOO  LOW 

Reason:  CA-View  writes  several  blocks  to  a  tape  voltune  simultaneously.  The 
maxbiks  specification  in  the  STORGRXx  parameter  is  below  this  number 
(currently  10). 


Action:  Correct  the  maxbiks  specification  in  the  STORGRXa:  parameter. 
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SARVOlOl 


SARV0102 


SARV0103 


SARV0104 


BAD  BLOCK  ID,  USING  TAPE  MARK  TO  APPEND 

Reason:  For  best  performance,  CA-View  uses  a  block  ID  to  locate  the  appendage 
point  on  a  tape  volume.  GA-View  did  not  find  the  correct  information  at  that 
point  on  the  tape  volume,  so  it  rewoimd  the  volume  and  used  forward-space-file 
to  locate  the  point  to  append  as  it  did  in  releases  prior  to  CA-View  1.7. 

Action:  Contact  Computer  Associates  Technical  Support  to  report  the  problem. 
The  message  is  informational  ordy,  and  if  the  locate  by  forward-space-ffle 
succeeds,  the  only  impact  is  on  performance.  If  the  locate  by  forward-space-file 
fails,  a  new  tape  volume  will  be  requested. 


VTAM  OPEN  FAILED,  ERROR=xx 

Reason:  An  error  occurs  while  issuing  an  open  AGB  request.  Code  rx  is  returned 
in  ACB  field  AGBERFLG. 


Action:  Consult  the  IBM  VTAM  Programmer  manual  for  explanation  on  error  for 
open  of  VTAM  ACB>  correct  and  retry. 


VTAM  OPENDST  FAILED,  LUsxxxxxxxx,  RTNCD=xx,  FDBK2=:xx, 
SENSEsxxxxxxxx 

Reason:  An  error  occurs  when  issuing  an  OPENDST  for  the  indicated  logical 
unit.  The  return  code,  feedback  code,  and  sense  information  are  shown. 

Action:  Consult  the  IBM  VTAM  Programmer  manual  ioi  explanation  on  error  for 
open  for  OPENDST,  correct  and  retry. 


VTAM  SEND  FAILED,  LU=xxxxxxxx,  RTNCD=xx,  FDBK2=xx, 
SENSEsxxxxxxxx 

Reason:  An  error  occurs  when  issuing  a  SEND  for  the  indicated  logical  vmit.  The 
return  code,  feedback  code,  and  sense  information  are  shown. 

Action:  Consult  the  IBM  VTAM  Programmer  manual  for  explanation  on  error  for 
SEND  to  VTAM  Device,  correct  and  retry. 


INVALID  DEVICE  FOR  VTAM  PRINT,  LU=xxxxxxxx 

Reason:  The  logical  unit  indicates  it  is  not  a  VTAM  logical  unit  as  reported  by  a 
value  other  than  DEVLU  being  returned  in  the  DEVTCODE  field  of  the  NIB  after 
the  OPENDST  is  completed. 


Diagnostic  and  Error  Messages  1 2-201 


Diagnostic  and  Error  Messages 


SARV0105 


SARV0106 


SARV0107 


SARV0108 


SARVCL99 


Action:  Use  a  AHOAM  device. 

NO  AVAILABLE  APPLIDS,  LU=xxxxxxxx,  APPLID=xxxxxxxx 


Reason:  The  task  of  successhiUy  opening  the  VTAM  ACB  while  processing  the 
logical  unit  indicates  that  it  is  not  possible  to  locate  an  available  APPLID  with  the 
indicated  value. 

Action:  Either  define  the  necessary  APPLIDs  to  VTAM  or  specify  an  existing 
APPLID  in  the  VPRTAPPL  initialization  parameter. 


VTAM  SIMLOGON  FAILED,  l[}=xxxxxxxx,  RTNCD=xx,  FDBK2=xx, 
SENSEsxxxxxxxx 

Reason:  An  error  occurs  when  issuing  a  SIMLOGON  for  the  indicated  logical 
imit.  The  return  code,  feedback  code,  and  sense  information  are  shown. 

Action:  Correct  the  error  and  retry. 


DEVICE  NOT  AVAILABLE,  W^xxxxxxxx 

Reason:  The  VTAM  printer  specified  as  xxxxxxxx  is  either  not  defined  to  VTAM 
or  is  busy  longer  than  the  retry  limits  specify  in  the  VPRTRTRY  and  VPRTRINT 
initialization  parameters. 

Action:  Either  use  a  printer  defined  to  VTAM,  or  if  the  printer  is  already  defined 
to  VTAM,  wait  tmtil  it  is  not  being  used. 


LOGMODE  NOT  AVAILABLE,  L[}=xxxxxxxx, 
LOGMODEsXXXXXXXX 

Reason:  The  LOGMODE  specified  in  the  DEFme  DEVice  for  logical  unit 
xxxxxxxx  is  not  available  to  VTAM; 

Action:  Either  make  the  LOGMODE  available  to  VTAM,  or  specify  a  usable 
LOGMODE  in  the  DEFine  DEVice  panel 


INCORRECT  LEVEL  OF  BASE  COMMON  CODE  -  BASE=V., 
REQ=V.M 


Reason:  An  rmusable  earlier  version  of  shared  common  code  has  been  detected. 
BASE  shows  the  version  detected,  REQ  shows  the  version  required. 
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SARVDRVl 


SARVDRV2 


SARVDRV3 


SARVDRV4 


SARVDRV5 


Action:  Correct  the  error  and  retry.  This  can  be  done  by  putting  the  CA-View 
LOADIlIB  ahead  of  EXPRESS,  BALANCING,  and/or  ARISE  LOADLIBs. 

xxxxxxxxx  TERMINAL  CONNECTED 

Reason:  The  VTAM  terminal  has  been  successfully  connected  to  the  user  subtask 
in  the  region.  This  message  has  a  MSGLVL  of  NORM. 

Action:  None.  This  is  an  informational  message. 


xxxxxxxxx  APPLICATION  ENDED 

Reason:  The  CA-View  program  has  ended  normally.  This  message  has  a 
MSGLVL  of  NORM. 

Action:  None.  This  is  an  informational  message. 


xxxxxxxxx  SESSION  CLSDST 

Reason:  A  VTAM  CLSDST  to  disconnect  the  terminal  will  now  be  issued.  This 
message  has  a  MSGLVL  of  TRCE. 

Action:  None.  This  is  an  informational  message. 


XXXXXXXXX  “‘REJECTED****  xxxxxxxxxxxx 

Reason:  CA-View  detected  a  problem  with  the  session  bind  parameters  and  has 
rejected  the  terminal  logon.  This  message  has  a  MSGLVL  of  ACTN. 

Action:  Review  the  REJECT  reason  for  the  appropriate  action. 


XXXXXXXXX  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  Displays  the  bad  bind  image  data  rejected  by  message  SARXDRV5.  This 
message  has  a  MSGLVL  of  ACTN. 

Action:  Contact  your  VTAM  systems  programmer  or  Computer  Associates 
Technical  Support.  This  may  be  a  VTAM  definition  problem. 
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SARVEND1 


SARVERRl 


SARVETXl 


SARVLGNl 


SARVLGN2 


BAD  SCREEN  SIZE=(/i/i,nn),  CHANGED  10=(nn,nn) 

Reason:  The  incorrect  screen  size  to  bind  data  will  change  to  conform  to  normal 
3270  screen  sizes.  This  message  has  a  MSGEVL  of  NORM. 

Action:  Contact  your  VTAM  systems  programmer.  This  may  be  a  VTAM 
definition  problem. 

SARAPPLID=xxxxxxxx  VTAM  TREND  RC=nn 

Reason:  The  VTAM  access  method  has  requested  closing  the  VTAM  AGB, 
because  of  command  processing  or  VTAM  shutdown.  This  message  has  a 
MSGLVLofCRIT. 

Action:  Contact  your  VTAM  systems  programmer. 


xxxxxxxx  REQ=xxxxx  RC=xxxx  FDBK2=xxxxx  xxxxxxxxxx 

Reason:  A  VTAM  error  has  occurred  processing  a  request  from  the  VTAM 
interface.  The  RC=  shows  the  problem  return  code.  This  message  has  a  MSGLVL 
ofAGTN. 

Action:  The  action  to  take  depends  on  the  session  status  and  type  of  error.  Most 
errors  show  communications  problems. 


XXXXXXXX  TASK  ENDED  or  ABENDED  nnnnn 

Reason:  The  VTAM  user  subtask  has  ended  normally  or  with  an  abend 
condition.  This  message  has  a  MSGLVL  of  NORM. 

Action:  None.  This  is  an  informational  message. 

XXXXXXXXXX  LOGON  REQUEST  RTUS=xxxxxxx  SLU=xxxxxxxx 

Reason:  The  VTAM  logon  request  has  been  received,  CA-View  will  attach  user 
subtask  to  support  the  user.. Thus  message  has  a  MSGLVL  of  INFO^ 

Action:  None.  This  is  an  informational  message. 


XXXXXXXXXX  ***REJECT***  xxxxxxxxxxxxxxxxxx 

Reason:  The  VTAM  logon  request  was  rejected,  the  message  shows  the  reason. 
This  message  has  a  MSGLVL  of  ACTN.. 
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SARVLGN3 


SARVLST1 


SARVLST2 


SARVLST3 


SARVPSOl 


Action:  Review  the  REJECT  reason  for  the  appropriate  action. 


xxxxxxxxxx  PASSING  TO  APPLID=xxxxxx  xxxxxxxxxxxxxxxx 

Reason;  The  VTAM  logon  request  was  not  accepted  by  this  region,  the  request  is 
passed  to  the  next  CA-View  region  for  processing.  This  message  has  a  MSGLVL 
of  NORM. 

Action:  None.  This  is  an  informational  message. 


XXXXXXXXXX  LOSTERM  RC=xx  xxxxxxxxxxxxxxxxxxxxxx 

Reason;  A  VTAM  session  has  been  lost  for  this  terminal.  This  message  has  a 
MSGLVL  of  NORM. 

Action:  VTAM  has  disconnected  the  terminal,  possibly  due  to  a  terminal  or 
network  outage. 


XXXXXXXXXX  SESSION  CLSDST 

Reason:  A  VTAM  CLSDST  to  disconnect  the  terminal  will  be  issued.  This 
message  has  a  MSGLVL  of  INPO.  This  message  occurs  at  the  normal  end,  or  an 
ABEND,  of  the  VTAM  session. 

Action:  None.  This  is  an  informational  message. 


XXXXXXXXXX  FORCED  OFF 

Reason:  The  VTAM  terminal  session  has  been  forced  off  successfully.  This 
message  has  a  MSGLVL  of  INFO: 

Action:  None.  This  is  an  informational  message. 


VTAM  OPEN  FAILED,  ERROR=xx 

Reason;  An  error  occurs  while  issuing  an  open  ACB  request.  Code  a:;c  is  returned 
in  ACB  field  ACBERFLG. 

Action:  Consult  the  IBM  VTAM  Programmer  manual  for  explanation  of  errors  for 
open  of  VTAM  ACB^correGt  and  retry. 
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SARVPS04 


SARVPS05 


SARVPS06 


(SARV0102)  VTAM  OPENDST  FAILED,  W-xxxxxxxx,  RTNCD=xx, 
FDBK2=:xx,  SENSE=xxxxxxxx 

Reason:  An  error  occurs  when  issuing  an  OPENDST  for  the  indicated  logical 
unit.  The  return  code,  feedback  code,  and  sense  information  are  shown. 


Action:  Consult  the  IBM  VTAM  Programmer  manual  for  explanation  of  errors  for 
open  for  OPENDST;  correct  and  retry. 


(SARV0103)  VTAM  SEND  FAILED,  LUsXXXXXXXX,  RTNCDsxx, 
FDBK2=xx,  SENSEsXXXXXXXX 

Reason:  An  error  occurs  when  issuing  a  SEND  for  the  indicated  logical  xmit.  The 
return  code,  feedback  code,  and  sense  information  are  shown. 

Action:  Consult  the  IBM  VTAM  Programmer  manual  for  explanation  of  errors  for 
SEND  to  VTAM  Device;  correct  and  retry. 


(SARV0104)  INVALID  DEVICE  FOR  VTAM  PRINT,  LU-xxxxxxxx 

Reason:  The  logical  imit  indicates  it  is  not  a  VTAM  logical  unit  as  reported  by  a 
value  other  than  DEVLU  being  returned  in  the  DEVTCODE  field  of  the  NIB  after 
the  OPENDST  is  completed. 


Action:  Use  a  VTAM  device. 


(SARV0105)  NO  AVAILABLE  APPLIDS,  L[}=xxxxxxxx, 
APPLID=xxxxxxxx 

Reason:  The  task  of  successfully  opening  the  VTAM  ACB  while  processing  the 
logical  unit  indicates  that  it  is  not  possible  to  locate  an  available  APPLID  with  the 
indicated  value. 

Action:  Either  define  the  necessary  APPLIDs  to  VTAM  or  specify  an  existing 
APPLID  in  the  VPRTAPPL  initialization  parameter. 


(SARV0106)  VTAM  SIMLOGON  FAILED,  L\J=xxxxxxxx, 
RTNCD=xx,  FDBK2=xx,  SENSE=xxxxxxxx 

Reason:  An  error  occurs  when  issuing  a  SIMLOGON  for  the  indicated  logical 
unit.  The  return  code,  feedback  code,  and  sense  information  are  shown. 

Action:  Correct  the  error  and  retry. 
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(SARV0107)  DEVICE  NOT  AVAILABLE,  lii^xxxxxxxx 

Reason:  The  VTAM  printer  specified  as  xxxxxxxx  is  either  not  defined  to  VTAM 
or  is  busy  longer  than  the  retry  limits  specify  in  the  VPRTRTRY  and  VPRTRINT 
initialization  parameters. 

Action:  Either  use  a  printer  defined  to  VTAM>  or  if  the  printer  is  already  defined 
to  VTAM,  wait  until  it  is  not  being  used. 


(SARV0108)  LOGMODE  NOT  AVAILABLE,  L[}=xxxxxxxx, 
LOGMODE=xxxxxxxx 

Reason:  The  LOGMODE  specified  in  the  DEFine  DEVice  for  logical  unit 
xxxxxxxx  is  not  available  to  VTAM. 

Action:  Either  make  the  LOGMODE  available  to  VTAM,  or  specify  a  usable 
LOGMODE  in  the  DEFine  DEVice  panel. 


OPN/CLOSE  ERROR  APPLID=xxxxxx  ACBERRFLG=xx 

Reason:  A  VTAM  OPEN  or  CLOSE  has  not  completed  successfully.  The  VTAM 
signon  task  will  be  shutdown.  This  message  has  a  MSGLVL  of  CRIT. 

Action:  Contact  your  VTAM  systems  programmer. 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  A  VTAM  OPEN  or  CLOSE  code  failure  reason.  This  message  has  a 
MSGLVL  of  CRIT. 

Action:  Contact  your  VTAM  systems  programmer. 


MODCB  ERROR  APPLID=xxxxxx 

Reason:  A  VTAM  MODCB  macro  has  failed,  the  VTAM  session  cannot  be 
initialized  and  the  E13VTSGN  program  will  shutdown.  This  message  has  a 
MSGLVL  of  CRIT. 

Action:  Contact  Computer  Associates  Technical  Support. 
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SARVSGN4  APPLID=xxxxxx  NOW  ACCEPTING  LOGONS 

Reason:  VTAM  signon  initialization  is  completed.  VTAM  users  can  now  sign 
onto  the  region.  This  message  has  a  MSGLVL  of  NORM. 

Action:  None.  This  is  an  informational  message. 

SARVSGN5  APPLID=xx>o«x  QUIESCE  PENDING,  WAITING  FOR  USERS  TO 

LOGOFF 

Reason:  The  console  operator  has  stopped  the  region,  but  users  are  still  active. 
The  VTAM  signon  task  will  wait  for  the  users  to  complete  processing.  This 
message  has  a  MSGLVL  of  NORM. 

Action:  None.  This  is  an  informational  message. 

SARVSGN6  VTAM  EXIT  xxxxxxxx  ACTIVE  ADDRnXXXXXX  x.x 

xxlxxfxx 

Reason:  The  indicated  VTAM' routine  loaded  and  attached  to  the  VTAM  AGB 
exit  list.  The  release  and  assembly  date  and  time  are  displayed.  This  message  has 
a  MSGLVL  of  INFO. 

Action:  None.  This  is  an  informational  message. 


SARVSTAl  xxxxxxxRECOVERY-xxxx 

Reason:  A  subtask  abend  has  been  detected  and  the  session  will  now  be  cleaned 
up.  This  message  has  a  MSGLVL  of  AGTN. 

Action:  None.  This  is  an  informational  message. 


SARVSTM 1  xxxxxxxxxx  USER  HAS  EXCEEDED  THE  LONGWAIT  TIME 

Reason:  The  terminal  shown  has  not  had  a  transaction  for  a  time  period 
exceeding  the  time  specified  in  the  LONGWArr=  parameter.  This  message  has  a 
MSGLVL  of  ACTN. 


Action:  If  CANGEL=YES  was  specified  for  the  region,  the  user  will  be  canceled. 
Otherwise  the  task  status  will  be  changed  to  LONGWAIT. 
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SARVTAOl 


SARVTA02 


SARVTA03 


SARVTA04 


SARVTA05 


SARVTA06 


SARVTA07 


OPEN  ERROR  APPLID=xxxxxxxx  ACBERFLG=xx 

Reason:  The  open  has  failed  for  application  program  ACB; 

Action:  Verify  that  the  SARVTAM  APPLID  is  activated.  Normally,  inactivating 
and  re-activating  the  SARVTAM  APPLID  will  fix  the  problem; 

APPLIDsxxxxxxxx  NOW  ACCEPTING  LOGONS 

Reason:  The  VTAM  online  retrieval  task  in  now  ready  for  users  to  logon  to  it. 
Action:  None.  This  is  an  informational  message. 

APPLID=xxxxxxxx  DISABLED  FOR  LOGONS 

Reason:  This  message  is  in  response  to  the  successful  quiesce  request. 

Action:  None.  This  is  an  informational  message. 

APPLIDsxxxxxxxx  NOW  CLOSED 

Reason:  The  application  is  terminating. 

Action:  None.  This  is  an  informational  message. 

INVALID  COMMAND  IGNORED 

Reason:  An  invalid  operator  command  has  been  issued. 

Action:  Re-enter  the  operator  command  in  its  correct  form. 


TASK  ABEND  xxx  xxxx 

Reason:  The  user  subt^khas  abended.  Consult  message  SARVTA14  for  further 
information. 

Action;  None.  This  is  an  informational  message. 


LOSTERM  REASONsxxxx  FOR  LU  xxxxxxxx 

Reason:  The  losterm  exit  has  been  invoked  for  the  session  with  the  specified  LU 
name.  The  session  is  terminated. 
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SARVTA08 


SARVTA09 


SARVTAIO 


SARVTAl  1 


SARVTA12 


SARVTA13 


Action:  None.  This  is  an  informational  message. 

TREND  REASON  xx 

Reason:  VTAM  has  been  terminated  with  a  Z  NET  or  V  NET,INACT  command. 
VTAM  online  retrieval  is  terminated. 

Action:  After  VTAM  has  been  started  again,  start  the  VTAM  online  retrieval 
task. 

LU  xxxxxxxx  STARTED 

Reason:  A  session  with  the  specified  logical  imit  has  started. 

Action:  None.  This  is  an  informational  message. 


LU  xxxxxxxx  ENDED 

Reason:  The  session  with  the  specified  logical  unit  has  terminated  normally. 
Action:  None.  This  is  an  informational  message. 

LU  REQ=xxxxxxxx  RTNCDsxxxx  FDBK2=xxxxxxxx 

Reason:  The  specified  VTAM  request  has  failed. 

Action:  Reference  the  return  and  feedback  codes  to  determine  the  cause  of  the 
error. 


RECURSIVE  ERRORS  AT  xxxxxxxx  xxxx  xxxxxxxx 

Reason:  An  attempt  to  recover  from  a  previous  error  has  failed. 
Action:  Consult  the  message  for  the  previous  error. 


LU  xxxxxxxx  DFASY  REQ  -  RPLCNTRL=; 


< 


Reason:  The  DEASY  exit  has  been  entered  for  the  specified  logical  unit. 
Action:  None.  This  is  an  informational  message. 
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SARVTA14 


SARVXITl 


SARVXIT2 


SARVXIT9 


SARXCTOl 
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LU  xxxxxxxx  ABEND  CMPC=xxxxxx 

Reason;  The  user  subtask  has  abended.  A  completion  code  of  306000  occurs 
when  the  CA-View  load  library  is  not  authorized.  The  session  with  the  user  is 
terminated. 

Action;  None.  This  is  an' informational  message. 


xxxxxxxxxxx  xxxxxxxRPLCtilL=xxxxxxxxx 

Reason;  An  exceptional  condition  was  reported  by  VTAM^ 

Action;  This  message  has  a  MSGLVL  of  NORM.  This  can  occur  for  a  number  of 
reasons.  For  further  mfcnrmation  contact  Computer  Associates  Technical  Support. 


xxxxxxxxxx  xxxxxxxPC\D=xxxxxx  REASON=xxxx 
SENSEsxxxx 

Reason;  An  exceptional  condition  was  reported  by  VTAM. 

Action;  This  message  has  a  IvKGLVL  of  NORM.  This  can  occur  for  a  number  of 
reasons.  For  more  information  contact  Computer  Associates  Technical  Support. 


XXXXXXXXXX  xxxxxxx 
xxxxxxxxxxxxxxxxxxxxxxxxx 

Reason;  An  exceptional  condition  was  reported  by  VTAM. 

Action;  This  message  has  a  MSGLVL  of  NOKVI.  This  can  occur  for  a  number  of 
reasons.  For  further  information  contact  Computer  Associates  Technical  Support. 


INVALID  EXCEPTION  TABLE  STATEMENT  -  IGNORED 
control  statement 

Reason:  The  control  statement  does  not  begin  with  a  slash  (/),  or  a  percent  sign 
(%).  The  control  statement  is  ignored. 

Action:  Correct  the  statement. 


Diagnostic  and  Error  Messages  1 2-21 1 


Diagnostic  and  Error  Messages 


SARXCT02 


SARXCT03 


SARXCT04 


SARXCT05 


SARXETXl 


SARXETX2 


INVALID  JOBNAME  IN  EXCEPTION  TABLE  STATEMENT  -  IGNORED 
control  statement 

Reason:  The  control  statement  contains  an  invalid  SYSOUT  ID;  The  control 
statement  is  ignored. 

Action:  Correct  the  statement. 

INVALID  PARAMETER  IN  EXCEPTION  TABLE  STATEMENT 
’parameter’-  IGNORED  control  statement 

Reason:  The  control  statement  contains  an  invalid  parameter.  The  parameter  is 
ignored. 

Action:  Correct  the  statement. 

TOO  MANY  PARAMETERS  FOR  SYSOUT  ID 

Reason:  Too  many  parameters  are  specified  for  the  SYSOUT  ID. 

Action:  Reduce  the  number  of  parameters  on  the  control  statement. 

NEW  EXCEPTION  CONDITION  TABLE  LOADED 

Reason:  The  Exceptional  Conditions  checking  table  parameters  have  been 
reloaded. 

Action:  None.  This  is  an  informational  message. 

xxxxxxxx  SESSION  HAS  ABENDED 

Reason:  The  XMS  user  subtask  has  terminated  abnormally.  This  message  has  a 
MSGLVLofNORM. 

Action:  None.  This  is  an  infomiational  message. 

XXXXXXXX  SESSION  HAS  ENDED 

Reason:  The  XMS  user  subtask  has  terminated  normally.  This  message  has  a 
MSGLVLofNORM. 

Action:  None.  This  is  an  mformational  message. 
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SARXETX3 


SARXFP01 


SARXSGN1 


SARXSGN2 


SARXSGN3 
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xxxxxxxx  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  The  XMS  user  subtask  has  terminated  and  an  internal  error  was 
detected  cleaning  up  the  session.  This  message  has  a  MSGLVL  of  NORM. 

Action:  Contact  Computer  Associates  Technical  Support. 


CRITICAL  ERROR.  PROGRAM  TERMINATED  WITH  DUMP. 

INVALID  bik 

Reason:  A  CA-View  program  has  terminated,  and  a  dump  was  generated.  In  this 
message,  Wfc  specifies  the  control  block  CA-View  expected  but  did  not  receive 
(usually  IFB>  SFB,  XFB,  or  DBB).  It  may  be  suffixed  with  a  number  indicating 
which  test  point  in  the  program  detected  the  problem. 

Action:  Send  the  dirmp  to  Computer  Associates  Technical  Support.  Restart 
whatever  program  was  terminated.  If  the  problem  recurs,  run  SARDBASE 
VERIFY  on  the  database.  If  the  problem  persists,  contact  Computer  Associates 
Technical  Support. 


xxxxxxxxxxx  SIGNON  IN  PROGRESS  RTUS=xxxxxxx 

SLUssXXXXXXXX 

Reason:  XMS  signon  request  received,  CA-View  wiU  attach  the  user  subtask  to 
support  the  user. 

Action:  None.  This  is  an  informational  message. 


xxxxxxxxxx  xxxxxxxxxxxxxxxxxxxxxxxx 

Reason:  XMS  signon  has  detected  an  internal  error  during  processing.  This 
message  has  a  MSGLVL  of  ACTN. 

Action:  Contact  Computer  Associates  Technical  Support. 


RTUS  COUNT  MISMATCH 

Reason;  XMS  found  the  coimt  of  active  users  in  the  XMEMCNTL  was  bad  and 
corrected  it.  This  message  indicates  CA-View  has  lost  track  of  the  correct  number 
of  users  in  the  region.  This  message  has  a  MSGLVL  of  ACTN. 

Action:  Contact  Computer  Associates  Technical  Support. 
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SARXSGN4 


SARXSTAl 


SARXSTMl 


SARXTDOI 


SARXTD02 


SARXTD03 


ASCB  LOCATE  FAILED 

Reason:  XMS  has  not  been  able  to  locate  its  ASCB  control  block.  This  message 
has  a  MSGLVL  of  AGTN. 


Action:  Contact  Computer  Associates  Technical  Support. 


xxxxxxxxxx  RECOVERY-xxxx 

Reason:  A  subtask  abend  has  been  detected  and  the  session  will  now  be  now  be 
cleaned  up.  This  message  has  a  MSGLVL  of  AGTN. 

Action:  None.  This  is  an  informational  message. 


XXXXXXXXXX  USER  HAS  EXCEEDED  THE  LONGWAIT  TIME 

Reason:  The  terminali  shown  has  not  had  a  transaction  for  a  time  period 
exceeding  the  time  specified  in  the  LONGWAlT=  parameter.  This  message has  a 
MSGLVL  of  AGTN. 

Action:  If  CANCEL=YES  was  specified  for  the  region,  the  user  will  be  canceled. 
Otherwise,  the  task  status  will  be  changed  to  LONGWAIT. 


REPLY  Y/N  TO  AUTHORIZE  CHANGE  TO  CA-VIEW  SYSTEM 
EXTENSIONS 

Reason:  SARXTD  has  been  started  to  change  or  turn  off  extensions. 

Action:  Reply  Y  to  authorize  the  change,  or  N  to  prevent  the  change. 

INVALID  REPLY 

Reason:  An  invalid  reply  has  been  given  to  message  SARXTDOI. 

Action:  Reply  correctly  to  message  SARXTDOI. 

AUTHORIZATION  DENIED 

Reason:  The  operator  has  replied  N  to  message  SARXTDOI. 

Action:  If  authorization  has  been  erroneously  denied,  start  SARXTD  again. 
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SARXTD04 


SARXTDOS 


SARXrD06 


SARXTD07 


SARXTDOS 


SARXTD09 


JOB  ACCOUNTING  NOT  IN  EFFECT 

Reason:  SARXTD  has  been  started  without  a  DD  statement  for  the  job 
accounting  data  set. 

Action:  Verify  that  job  accounting  is  not  to  be  in  effect. 


JOB  ACCOUNTING  DATASET  CAN  ONLY  HAVE  ONE  EXTENT 

Reason:  The  job  accounting  data  set  can  only  have  one  extent. 

Action:  Recreate  the  job  accounting  data  set. 


INVALID  PARAMETER  AT  xxxxx 

Reason:  The  FARM  field  contains  invalid  syntax  starting  with  the  first  character 
displayed. 

Action:  Correct  the  FARM  field  and  start  SARXTD  again. 


SECURITY  ENABLED  FOR  DATASET  PREFIX  xxxxxxxxxxxxxxxxx 

Reason:  Data  set  security  is  in  effect  for  all  data  sets  whose  names  begin  with  the 
specified  prefix. 

Action:  None.  This  is  an  informational  message. 


ACCOUNTING  ENABLED  FOR  DATASET  dsname 

Reason:  Job  accounting  information  is  maintained  in  the  specified  accorintmg 
data  set. 

Action:  None.  This  is  an  mformational  message. 


AUTOMATIC  REPORT  ARCHIVAL  ENABLED  WITH  SPECIFICATIONS 
archival-criteria 

Reason:  The  automatic  report  archival  feature  is  active  and  the  specified 
archival  criteria  is  in  effect. 

Action:  None.  This  is  an  informational  message. 
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SARXTDIO 


SARXTDll 


SARXTD12 


SARXTD13 


SARXTD14 


SECURITY  DISABLED 

Reason:  Data  set  security  is  no  longer  in  effect. 
Action:  None.  This  is  an  informational  message. 


ACCOUNTING  DISABLED 

Reason:  Job  accounting  data  is  no  longer  being  maintained. 
Action:  None.  This  is  an  informational  message. 


AUTOMATIC  REPORT  ARCHIVAL  DISABLED 

Reason:  The  automatic  report  archival  feature  is  no  longer  in  effect. 
Action:  None.  This  is  an  mformational  message. 


INVALID  OPERATOR  COMMAND 

Reason:  When  systems  extensions  is  started  and  contains  a  NOTERM  DD 
statement,  the  system  extensions  task  remains  active  and  responds  to  operator 
commands.  The  MODIFY  ccanmand  that  was  entered  at  the  operator  console  is 
invalid. 

Action:  The  valid  operator  commands  that  can  be  entered  are:  OFF,  OFFSEC, 
OFFACT,  OFFARA,  STATUS,  and  STOP.  The  system  extensions  task 
automatically  terminates  when  the  OFF  or  STOP  commands  are  entered,  or  when 
all  the  system  extension  facilities  have  been  disabled. 


CA-VIEW  SYSTEM  EXTENSION  IS  ALREADY  ACTIVE  ON  THE 
SYSTEM 

Reason:  A  system  extensiox©  task  is  already  active  for  the  subsystem  identifier. 
Each  system  extensions  task  is  assigned  a  one  character  subsystem  identifier, 
which  can  be  defined  by  using  the  SUBSYSx  DD  statement,  and  a  system 
extensions  task  currently  is  executing  with  the  same  identifier.  Execution  of  the 
recently  started  task  is  terminated. 

Action:  If  an  additional  system  extension  task  is  required,  specify  a  xmique 
subsystem  identifier  by  using  the  SUBSYSr  DD  statement.  Otherwise,  verify  that 
the  previously  started  systems  extensions  task  specifies  the  desired  parameters.  If 
not,  terminate  the  previously  started  systems  extensions  task,  and  start  the  new 
task. 


1 2-216  CA-View  System  Reference  Guide 


Diagnostic  and  Error  Messages 


SARXTD15 


SARXTD16 


SARXTDIS 


SARXTD99 


XMSCG001 


CA-VIEW  SYSTEM  EXTENSIONS  2.0  IS  NOW  INACTIVE 

Reason:  Informational  message  indicating  that  all  facilities  for  the  system 
extensions  task  have  been  disabled,  and  the  systems  extensions  task  is 
terminating. 


Action:  None.  This  is  an  informational  message. 

SARXTD  IS  NOT  A  STARTED  TASK 

Reason:  An  attempt  has  been  made  to  execute  SARXTD  as  other  than  a  started 
task. 

Action:  Execute  SARXTD  by  using  the  START  command. 


SARXTD  REQUIRES  APF-AUTHORIZATION 

Reason:  SARXTD  has  determined  that  it  lacks  required  APF-authorization. 
SARXTD  requires  APF-authorization  in  order  to  d5mamically  modify  various 
operating  system  interfaces. 

Action:  Ensure  that  SARXTD  resides  in  an  APF-authorized  load  library. 
Alternatively,  SARXTD  can  be  placed  in  a  link  list  library  provided 
LNKAUTH=LNKLST  has  been  specified  or  allowed  to  default  in  the  active 
IEASYSx;c  member  of  SYS1.PARMLIB.  Under  no  circumstances  should  SARXTD 
be  placed  in  any  of  the  link  pack  areas. 


action  SUPPRESSED  FOR  dsname 

Reason:  CA-View  system  extensions  have  prevented  the  specified  action  (OPEN, 
OPEN  J,  SCRATCH,  or  RENAME)  from  being  performed  on  the  specified  data 
set.  With  the  security  feature  of  system  extensions  enabled,  only  authorized 
programs  recognized  by  CA-View  are  allowed  to  access  CA-View  data  sets. 

Action:  Normally,  no  action  is  required;  system  extensions  are  controlling  access 
to  CA-View  data  sets  as  requested.  However,  in  an  emergency,  the  security 
feature  of  system  extensions  can  be  disabled  in  order  to  allow  unrestricted  access 
to  CA-View  data  sets. 


USERMAX  CHANGED 

Reason:  This  is  an  informational  message. 
Action:  None.  This  is  an  informational  message. 
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XMSCG002  CHANGE  REQUEST  DOES  NOT  SPECIFY  parameter,  REQUEST 

IGNORED 

Reason:  Change  request  has  specified  an  tinknown  parameter. 

Action:  Correct  and  retry. 


XMSCG003  INVALID  QUOTED  STRING,  REQUEST  IGNORED 

Reason:  Invalid  quoted  string. 

Action:  Correct  and  retry. 


XMSCG004  USERMAX  VALUE  NOT  SPECIFIED.  REQUEST  IGNORED 

Reason:  USERMAX  value  not  specified. 

Action:  Correct  and  retry. 

XMSCG005  INVALID  USERMAX  VALUE  -  EITHER  NOT  A  NUMBER  OR  ZERO, 

REQUEST  IGNORED 

Reason:  An  invalid  USERMAX  parameter  has  been  specified. 

Action:  Correct  and  retry. 


XMSCLOOl  CANCEL  REQUEST  MUST  SPECIFY  EITHER  ALL,  USER=  OR  UID#=, 

REQUEST  IGNORED 

Reason;  An  invalid  CANCEL  REQUEST  has  been  specified. 

Action:  Correct  and  retry. 

XMSCL002  INVALID  QUOTED  STRING,  REQUEST  IGNORED 

Reason:  An  invalid  QUOTED  STRING  has  been  specified. 


Action:  Correct  and  retry. 
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XMSCL003 

INVALID  USER  NAME  -  ONLY  20  CHARACTERS  ALLOWED, 
REQUEST  IGNORED 

Reason:  An  invalid  USER  NAME  has  been  specified. 

Action:  Correct  and  retry. 

XMSCL004 

USER  NAME  OR  NUMBER  NOT  SPECIFIED,  REQUEST  IGNORED 

Reason:  The  USER  NAME  or  USER  NUMBER  has  not  been  specified. 

Action:  Correct  and  retry. 

XMSCL005 

INVALID  USER  NUMBER  -  EITHER  NOT  A  NUMBER  OR  ZERO, 
REQUEST  IGNORED 

Reason:  An  invalid  USER  NUMBER  has  been  specified. 

Action:  Correct  and  retry. 

XMSCL006 

CANCEL  REQUEST  SPECIFIED  SOME  USERS  WHO  WERE  NOT 
FOUND  AND  CANCELED 

Reason:  This  is  an  informational  message. 

Action:  None. 

XMSCL007 

NO  USERS  CURRENTLY  CONNECTED,  CANCEL  REQUEST 
IGNORED 

Reason:  This  is  an  informational  message. 

Action:  None. 

XMSCL099 

INTERNAL  ERROR  HAS  OCCURRED  IN  CANCEL  COMMAND, 
REQUEST  IGNORED 

Reason:  Internal  error. 

Action:  Contact  Computer  Associates  Technical  Support. 
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XMSLS001 


XMSLS002 


XMSLS003 


XMSLS004 


XMSLS005 


XMSLS006 


NO.  USERID  APPL  STATUS  DATABASE 

Reason:  This  is  an  informational  message  in  response  to  a  list  request. 
Action:  None. 


nnn  uuuuuuuu  aaaaaaaa  ssssssss  dddddddddddddddd 

Reason:  Reason:  This  is  an  informational  message  in  response  to  a  list  request, 
issued  with  XMSLSOOl,  which  identifies  the  fields  (USERID;  APPL,  etc.). 

Action:  None.  This  is  an  informational  message. 


NAME  USERMAX  USERS  STATUS 

Reason:  This  is  an  informational:  message  in  response  to  a  list  request. 
Action:  None.  This  is  an  informational  message. 


XXXXXXXXXXX  XXX  xxxxxxxxxx 

Reason:  This  is  an  informational  message  in  response  to  a  list  request. 
Action:  None.  This  is  an  informational  message. 


LIST  REQUEST  DOES  NOT  SPECIFY  STATUS,  USERS  OR  USER/UID#, 
REQUEST  IGNORED 

Reason:  The  LIST  REQUEST  does  not  specify  STATUS,  USERS,  or  USER  ID 
number. 

Action:  Correct  the  problem,  then  retry. 


INVALID  USER  NAME  -  ONLY  20  CHARACTERS  ALLOWED, 
REQUEST  IGNORED 

Reason:  An  invalid  USER  NAME  has  been  specified. 

Action:  Correct  the  problem,  then  retry. 
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XMSLS007 

INVALID  QUOTED  STRING.  REQUEST  IGNORED 

Reason:  An  invalid  QUOTED  STRING  has  been  specihed. 

Action:  Correct  the  proWem,  then  retry. 

XMSLS008 

NO  USER  NAME  OR  UID#  IS  SPECIFIED,  REQUEST  IGNORED 

Reason:  No  USER  NAME  or  UID#  has  been  specified. 

Action:  Correct  the  proWem>  then  retry. 

XMSLS009 

INVALID  UID#  VALUE  -  EITHER  NOT  A  NUMBER  OR  ZERO, 

REQUEST  IGNORED 

Reason:  An  invalid  UIE)#  has  been  specified. 

Action:  Correct  and  retry. 

XMSLS010 

THERE  ARE  NO  USERS  CURRENTLY  CONNECTED 

Reason:  No  users  are  connected. 

Action:  None.  This  is  an  informational  message. 

XMSLS01 1 

NO  USERS  DISPLAYED 

Reason:  No  users  are  displayed. 

Action:  None.  This  is  an  mformational  message. 

XMSLS098 

LIST  command 

Reason:  This  message  displays  the  previously  entered  cross-memory  started  task 
command. 

Action:  None.  This  is  an  informational  message. 
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XMSLS099 


XMSPM001 


XMSQU001 


XMSRS001 


XMSRS002 


XMSRS003 


XMSSD001 


INTERNAL  ERROR  HAS  OCCURRED  IN  LIST  COMMAND,  REQUEST 
IGNORED 

Reason:  This  is  an  informational  message. 

Action:  Contact  Computer  Associates  Technical  Support. 

REQUESTED  COMMAND  IS  UNKNOWN  -  REQUEST  WILL  BE 
IGNORED 

Reason:  The  request  from  an  MVS  modify  command  carmot  be  recognized. 
Action:  Correct  the  problem,  then  retry. 

CROSS-MEMORY  SYSTEM  QUIESCE  HAS  BEEN  INITIATED 

Reason:  The  quiesce  has  been  initiated. 

Action:  None.  This  is  an  informational  message. 

SIGNONS  RESUMED 

Reason:  The  signons  are  resinned. 

Action:  None.  This  is  an  informational  message. 

SIGNONS  NOT  SUSPENDED  -  REQUEST  IGNORED 

Reason:  The  request  is  ignored. 

Action:  None.  This  is  an  informational  message. 

SYSTEM  IS  QUIESCING  -  REQUEST  IGNORED 

Reason:  The  request  is  ignored. 

Action:  None.  This  is  an  informational  message. 

IMMEDIATE  SHUTDOWN  HAS  BEEN  STARTED 

Reason:  Shutdown  has  been  started. 
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Action:  None.  This  is  an  informational  message. 


XMSSPOOl 


XMSSP002 


SIGNONS  SUSPEN[>ED 

Reason;  The  signons  are  suspended. 

Action:  None.  This  is  an  information  message. 

SIGNONS  ALREADY  SUSPENDED  -  REQUEST  IGNORED 

Reason:  The  request  is  ignored. 

Action:  None.  This  is  an  informational  message. 


XMSSP003 


XMSXDOOl 


SYSTEM  IS  QUIESCING  -  REQUEST  IGNORED 

Reason;  The  request  is  ignored. 

Action:  None.  This  is  an  informational  message. 

PARAMETER  STRING  TOO  LONG  -  RUN  ABORTED 

Reason;  Input  parameter  is  too  long. 

Action:  Check  the  parameter  field  on  the  EXEC  statement. 


XMSXD002  CROSS-MEMORY  SYSTEM  MUST  BE  A  STARTED  TASK  -  RUN 

ABORTED 

Reason:  CA-View  has  aborted  the  job  nm  because  the  cross-memory  system  is 
not  a  started  task. 

Action:  Correct  and  retry. 


XMSXD003  NO  MEMORY  FOR  ANCHOR  SSCT  -  RUN  ABORTED 

Reason:  Unable  to  obtain  CSA  for  SSCT. 

Action;  Contact  your  systems  programmer. 
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XMSXD004 


XMSXD005 


XMSXD006 


XMSXD007 


XMSXD008 


XMSXD009 


NO  MEMORY  FOR  CROSS-MEMORY  SYSTEM  CONTROL  BLOCK  - 
RUN  ABORTED 

Reason:  Unable  to  obtain  CSA  for  XMCT. 

Action:  Contact  your  systems  programmer. 

A  CROSS-MEMORY  SYSTEM  WITH  THE  SAME  IDENTIFICATION  IS 
CURRENTLY  ACTIVE 

Reason:  A  cross-memory  system  running  has  the  same  ID. 

Action:  Change  XMS  identification  and  retry. 

AHACH  OF  THE  OPERATOR  COMMUNICATION  INTERFACE 
ROUTINE  FAILED  -  RUN  ABORTED 

Reason:  The  cross-memor>'  system  is  not  able  to  attach  to  the  operator 
communication  interface. 

Action:  Contact  Computer  Associates  Technical  Support. 

AHACH  OF  CROSS-MEMORY  SIGNON  ROUTINE  FAILED  -  RUN 
ABORTED 

Reason:  The  cross-memory’  SIGNON  is  not  able  to  attach. 

Action:  Contact  Computer  Associates  Technical  Support. 

NO  STARTUP  PARAMETER  SPECIFIED  -  RUN  ABORTED 

Reason:  The  cross-memory'  system  startup  parameter  is  not  specified. 

Action:  Specify  a  parm  field  on  the  EXEC  statement 

INVALID  CROSS-MEMORY  IDENTIFICATION  PARAMETER  -  RUN 
ABORTED 

Reason:  The  input  XMS  ID  is  too  long. 

Action:  Check  parm  field  on  EXEC  statement. 
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XMSXD010 


XMSXDOl  1 


XMSXD012 


XMSXDOl  3 


XMSXDOl  4 


XMSXD090 


XMSXD091 


INVALID  USERMAX  PARAMETER  -  RUN  ABORTED 

Reason:  The  USERMAX  initialization  parameter  is  not  specified. 

Action:  Specify  a  USERMAX  parameter  on  the  EXEG  statement. 

SPECIFIED  PARAMETER  IS  UNKNOWN  -  RUN  ABORTED 

Reason:  The  input  parameter  is  unknown. 

Action:  Check  parm  field  on  EXEC  statement. 

INVALID  LONGWAIT  PARAMETER  -  RUN  ABORTED 

Reason:  The  LONGWAIT  parameter  on  the  EXEC  statement  is  invalid. 

Action:  Correct  and  retry. 

INVALID  CANCEL  PARAMETERS  -  RUN  ABORTED 

Reason:  The  CANCEL  parameter  on  the  EXEC  statement  is  invalid. 

Action:  Correct  and  retry. 

INVALID  SUBSYS  PARM,  RUN  ABORTED 

Reason:  The  SUBSYS  parameter  on  the  cross-memory  EXEC  statement  is  invalid. 
Action:  Correct  the  SUBSYS  parameter,  then  restart. 

PC  ROUTINE  wm/r  ACTIVE  ADDR=aooaaaaa  w  dd/mmlyy 
hh/mm 

Reason:  This  is  an  informational  message. 

Action:  None. 

PC  ASIDsxxxx  XMEMCNTL  ADDR=aaaaaoaa  lD=xxxxxxxx 

Reason:  This  is  an  informational  message. 

Action:  None. 


Diagnostic  and  Error  Messages  12-225 


Diagnostic  and  Error  Messages 


XMSXE001 


XMSXE002 


XMSXE003 


XMSXE004 


XMSXE005 


XMSXE006 


XMSXE007 


USER  CONNECTION  xxxxxxxxxxxxxxxxxxxxxx  HAS  ENDED 

Reason:  The  user  connection  has  ended. 

Action:  None.  This  is  an  informational  message. 

USER  CONNECTION  xxxxxxxxxxxxxxxxxxxxxx  ABEND  xxxx 

Reason:  The  user  connection  has  abended. 

Action:  None.  This  is  an  informational  message. 

UNABLE  TO  LOCATE  USERS  ASCB  -  CONNECTION  TERMINATED 

Reason:  This  is  an  informational  message. 

Action:  Contact  Computer  Associates  Technical  Support. 

UNABLE  TO  LOCATE  CROSS-MEMORY  CONTROL  BLOCK  -  RUN 
ABORTED 

Reason:  Internal  error. 

Action:  Contact  Computer  Associates  Technical  Support. 

CROSS-MEMORY  CONTROL  BLOCK  IS  INVALID  -  RUN  ABORTED 

Reason:  Internal  error. 

Action:  Contact  Computer  Associates  Technical  Support. 


UNABLE  TO  LOCATE  USER  INFORMATION  CONSOLE  TABLE  -  RUN 
ABORTED 

Reason:  Internal  error. 

Action:  Contact  Computer  Associates  Technical  Support. 


UNABLE  TO  LOCATE  USER  CONNECTION  TCB  -  RUN  ABORTED 


Reason:  Internal  error. 
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XMSXOOOl 


XMSXSOOl 


XMSXS002 


XMSXS901 


XMSXS902 


Action:  Contact  Computer  Associates  Technical  Support. 


OPERATOR  FUNCTION  REQUESTED  IS  NOT  SUPPORTED 

Reason:  The  request  from  an  MVS  modify  command  cannot  be  recognized. 
Action:  Correct  and  retry. 


USER  CONNECTION  xxxxxxxxxxxxxxxxxxxxxxxx  SIGNON  IN 
PROGRESS 

Reason:  The  signon  is  in  progress. 

Action:  None.  This  is  an  informational  message. 


UNABLE  TO  LOCATE  USER  SIGNON  ASCB  -  SIGNON  IGNORED 

Reason:  Internal  error. 

Action:  Contact  Computer  Associates  Technical  Support. 


INTERNAL  ERROR  -  INVALID  RTUS  fOmOiaaaaaaaa  nnn 
xxxxxxxxxxx 

Reason:  Internal  error. 

Action:  Contact  Computer  Associates  Technical  Support. 


INTERNAL  ERROR  -  RTUS  COUNT  MISMATCH,  CONTROL 
TABLE  ADJUSTED  ACTIVE  INACT  TOTAL  | 

(COMPUTED)  nnnnn  nnnnn  nnnnn 

Reason:  The  cross-memory  system  has  detected  an  internal  error  and  has 
recovered  from  it. 

Action:  Contact  Computer  Associates  Technical  Support. 
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In  This  Appendix 

This  appendix  discusses  the  data  sets  used  by  CA-View. 


CA-View  Data  Sets 

The  following  data  sets  are  used  by  CA-View; 

■  CA-View  database 

■  Optional  lock  data  set 

■  Tape  archival  data  sets 

■  Tape  duplex  data  sets 

■  Load /unload  data  sets 

■  Recovery  data  set 

■  Accounting  file 

■  Exceptional  condition  table 

■  Expanded  retention  table 

These  are  all  discussed  in  the  following  sections. 


The  CA-View  Database 

The  CA-View  database  is  a  set  of  one  or  more  direct-access  data  sets  containing 
the  master  index  and  the  disk-archived  SYSOUT.  The  database  is  created  and 
maintained  with  the  SARDBASE  utility.  The  master  index  is  initialized  and 
modified  with  the  SARINTT  utility. 

The  database  is  designed  for  high  performance  and  quick  access.  Data  is  stored  in 
a  compressed  format  to  minimize  space  requirements. 
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The  CA-View  Database 


A  maximtim  of  127  data  sets  can  be  defined  for  the  database;  however,  for 
performance  considerations,  it  is  preferable  to  use  a  small  number  of  large  data 
sets  rather  than  a  large  number  of  small  data  sets. 


Attributes  and  Naming  Convention 


The  data  sets  comprising  the  database  have  the  following  attributes: 

DSORGsDA 

REGFM=P 

BLKSXZE=3476 

SPACE= (CYL, , , CONTIG) 


Although  the  data  sets  are  marked  as  movable,  they  can  only  be  moved  to  a 
volume  of  the  same  device  t5^e.  Each  data  set  must  also  occupy  one  contiguous 
extent,  occupy  the  same  number  of  cylinders,  and  be  allocated  on  a  cylinder 
extent  boimdary. 

The  data  sets  are  assigned  names  in  the  following  format: 

Syntax  index.  SARDBASE  .  Pnnnnwnn 

where: 

index  Specifies  the  high-level  name  of  the  database 

The  index  comprises  one  or  more  qualifiers  separated  by 
periods.  The  maximum  length  of  the  index  is  17  characters. 

nnnnnnn  Specifies  the  relative  sequence  number  of  the  data  set  within  the 
database 


Master  index 


The  master  index  contains  the  following  types  of  records: 

■  Master  control  record  (MGR) 

The  MGR  contains  the  control  information  for  GA-View,  including  the 
initialization  parameters  that  have  been  selected.  There  is  only  one  MGRv 

■  Tape  control  record  (TGR) 

The  TGR  identifies  the  tape  archival  and  tape  duplex  data  sets.  There  is  one 
TGR  for  each  tape  volume. 
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■  Group  control  record  (GCR) 

The  GGR  describes  file  characteristics  of  each  SYSOUT  group  that  is 
archived.  There  is  one  GCR  for  each  SYSOUT  group. 

■  User  attribute  control  record  (UCR) 

The  UGR  describes  the  attributes  for  the  online  users  (for  example,  PF  key 
definitions).  There  is  one  UCR  for  each  attribute  for  each  user. 

■  Online  member  control  record  (OCR) 

The  OCR  describes  the  panels,  messages,  and  skeleton  JCL  members  loaded 
from  the  online  library.  There  is  one  OCR  for  each  panel;  message,  and 
skeleton  JCL  member. 

■  Expanded  retention  control  record  (PCR) 

The  PCR  contains  the  control  information  for  the  Expanded  Retention  Option 
(formerly  known  as  the  Permanent  Archival  Option  or  PAO).  There  is  oidy 
one  PCR,  and  is  only  present  if  the  Expanded  Retention  Option  is  installed. 

■  View  control  record  (V GR) 

The  VCR  contains  a  logical  view  definition.  There  is  one  VCR  for  each  logical 
view  defined. 

■  Alternate  index  control  record  ( ACR) 

The  ACR  consists  of  an  index  of  SYSOUT  IDs  within  generation  number. 
There  can  be  many  ACRs  in  a  CA-View  database. 

Mapping  macros  for  die  records  (SARMGR,  SARTCR,  SARGCR,  SARUCR, 
SAROCR,  SARVCRy  SARPCR  and  SARAGR)  and  a  COBOL  copy  book 
defining  the  records  ^ARGBREC)  are  provided  in  VIEW.SOURCE. 


Optional  Lock  Data  Set 

An  optional  lock  data  set  can  be  created  with  the  SARDBASE  ADDLOCK 
command  and  deleted  by  the  SARDBASE  DELETE  [LOCK]  command.  It  is  used 
to  serialize  CA-View  database  access  in  environments  where  the  hardware 
reserve/releases  cannot  be  used  (such  as  in  multi-CPU  VM  installations). 


Attributes 


The  DGB  attributes  for  this  data  set  are  as  follows: 

DS0R6=DA 

RECFM=F 

BI.KSIZB=256 
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Tape  Archival  Data  Set 


The  tape  archival  data  sets  (also  referred  to  as  backup  tape  data  sets)  are 
automatically  created  and  deleted  by  CA-View.  One  data  set  is  created  per  tape 
volume.  SYSOUT  groups  and  the  backup  of  the  master  index  are  written 
sequentially  to  the  same  tape  data  set  and  are  separated  from  each  other  by  tape 
marks.  The  first  record  written  to  the  tape  for  a  SYSOUT  group  is  the  group's 
OCR.  In  this  manner,  CA-View  can  quickly  "spin  down"  to  any  SYSOUT  group 
for  retrieval. 


As  much  SYSOUT  as  can  fit  on  a  tape  is  written  to  that  tape.  When  the  end  of  the 
tape  is  sensed  or  an  I/O  error  occurs,  CA-View  terminates  the  tape  data  set, 
allocates  a  new  data  set  on  another  tape  volume,  and  continues  writing  to  the 
new  volume. 


Initialization  Parameters  and  Tape  Archival 

The  rmit  name  used  for  allocation  is  specified  by  the  UNITT  initialization 
parameter.  The  TVSERl  and  TVSER2  parameters  can  be  specified  to  assign  a 
range  of  tapes  for  CA-View  to  use.  The  MAXGENT  initialization  parameter  can 
be  used  to  limit  the  number  of  generations  of  SYSOUT  that  are  written  to  the 
same  tape  volume. 

As  part  of  its  backup  cycle,  CA-View  imcatalogs  any  tape  that  is  no  longer 
needed.  The  EXPDT  initialization:  parameter  can  be  used  to  determine  when  a 
tape  is  actually  available  for  scratch. 


Copying  Tapes 


Due  to  the  special  format  of  the  CA-View  tape  archival  data  sets,  normal  utilities 
generally  cannot  be  used  to  copy  archival  tapes.  A  special  utility,  SARTCP,  is 
provided  for  this  purpose.  In  addition,  the  utility  maps  the  contents  of  a  tape  and 
can  be  used  to  salvage  SYSOUT  from  a  damaged  tape.  See  Tape  Management 
Scratch  and  Clean  Utility  (SARTCHK)  in  Chapter  7,  "Database  Utilities,"  for  a 
complete  description. 


Attributes  and  Naming  Convention 

DCB  attributes  for  the  data  sets  are: 

REGFM=VB 

LRECb=32756 

BLKSXZE=32760 


A-4  CA- View  System  Reference  Guide 


Tape  Duplex  Data  Set 


The  data  sets  are  assigned  names  in  the  following  format; 

Syntax  index.  SARTAPE  .  'PnnTinrinn 

where: 

index  Specifies  the  high-level  index  used  to  name  the  CA-View  database 

nnnnnnn  Specifies  the  sequence  number  of  the  tape  data  set 


Tape  Duplex  Data  Set 

The  tape  duplexing  feature  of  CA-View  allows  a  site  to  obtaima  duplicate  copy  of 
their  backup  tape  data  sets.  When  this  feature  is  activated,  an  additional  tape  is 
moimted  during  the  backup  cycle  and  during  direct  to  tape  archival.  AH  I/O  to 
the  original  backup  tape  is  simultaneously  written  to  the  duplex  tape  data  set. 
This  feature  is  activated  by  having  a  second  unit  present  on  the  UNITT 
initialization  parameter. 

Tape  duplex  data  sets  are  created  and  deleted  in  the  same  method  as  tape 
archival  data  sets. 

The  unit  name  used  for  allocation  is  specified  by  the  UNITT  initialization 
parameter.  The  TVSERl  and  TVSER2  parameters  can  be  specified  to  assign  a 
range  of  tapes  for  GA-View  to  use. 


Attributes  and  Naming  Convention 

DCB  attributes  for  the  data  sets  are: 

RECFH=VB 

LRECL=32756 

BI>KSXZE=32760 


The  data  sets  are  assigned  names  in  the  following  format: 

Syntax  index .  SARDPIOC .  Unnnnnnn 

where: 

index  Specifies  the  high-level  index  used  to  name  the  CA-View  database 

nnnnnnn  Specifies  the  sequence  number  of  the  tape  data  set 

This  number  is  the  same  as  the  sequence  number  from  the  original 
backup  tape. 
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Load/Unload  Data  Sets 


The  UNLOAD  SARDBASE  database  function  creates  a  sequential  data  set  for 
backup  purposes.  The  database  records  are  written  in  ascending  key  sequence 
order  to  the  data  set.  This  data  set  can  be  used  ata  later  time  to  restore  tine 
contents  of  the  designated  database  using  the  LOAD  function. 

If  the  output  data  set  is  tape,  duplexing  is  not  done. 


Attributes  and  Naming  Convention 

DCB  attributes  for  the  data  sets  are: 

RECFH=VB 

LRECL=32756 

BLKSXZE=32760 

The  output  data  set  is  assigned  a  name  as  designated  by  the  user. 


Recovery  Data  Set 

This  data  set  resides  on  a  direct-access  volume  and  is  used  by  the  backup  process 
of  the  archival  task  to  keep  track  of  the  tapes  used  to  backup  the  database.  The 
recovery  data  set  is  allocated  as  part  of  the  installation  procedure. 

This  data  set  is  referenced  by  the  GA-View  archival  task  and  other  utilities  by 
using  the  SARREGV  DD  statement.  See  the  section  Recovery  Data  Set  in 
Chapter  3,  "Configuring  CA-View,"  for  more  information. 


Attributes  and  Naming  Conventions 

DCB  attributes  for  the  data  set  are: 

REeFM=F 

LKE:CL=12288 

BLKSZZE=12288 


Forward  Recovery  Data  Set 

This  data  set  resides  on  a  direct-access  volume  and  is  used  by  the  archival  task  to 
store  SYSOUTs  that  are  archived  to  the  database.  The  forward  recovery  data  set 
is  allocated  as  part  of  the  installation  procedure. 
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See  the  section  Forward  Recovery  in  Chapter  8,  "Backing  Up  and  Recovering  the 
Database"  for  more  information. 


Attributes 


DCB  attributes  for  the  data  set  are: 

RECFHsU 

I>SECL=0 

BLKSZZE=32760 

The  data  sets  are  assigned  names  in  the  following  format; 
index.  SABFROS .  Dmmnnrm 

where: 

index  Specifies  the  high-level  index  used  to  name  the  CA-View 

database 

nnnnnnn  Specifies  the  sequence  number  of  the  disk  data  set 


Accounting  File 

The  accounting  file  is  a  direct-access  data  set  used  to  maintain  accounting  data  on 
jobs  for  use  by  the  archival  started  task.  The  data  set  is  defined  and  initialized  as 
part  of  the  installation  procedure. 

A  logical  record  in  the  file  contains  an  8-byte  jobname  and  20  bytes  of  accounting 
data  selected  from  type-20  SMF  records  by  the  SARAGTUX  user  exit.  The 
location  of  the  logical  record  in  the  file  corresponds  to  the  job  ID  of  the  job. 

The  accounting  file  is  only  used  when  job  accounting  is  initiated  as  a  CA-View 
extension. 


Attributes 


DCB  attributes  for  the  file  are: 

BECFH=FB 

LRECI>=28 

BLKSXZEs2800 
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Exceptional  Condition  Table 

The  exceptional  condition  table  or  exception  table  ts  a  sequential  data  set  that 
contains  control  statements  defining  specifications  for  exceptional  condition 
checking.  The  data  set  is  allocated  to  the  CA-View  archival  started  task  with  the 
SARXGTAB  DD  statement  See  Exceptional  Condition  Qiecking  in  Chapter  5, 
"Archival,"  for  a  complete  description. 


Attributes 

DCB  attributes  for  the  file  are: 

RECFM=F  or  FB 

LREGL=80 

BLKSZZE=il2Uinn 

where  nnnnn  is  a  multiple  of  80. 


Expanded  Retention  Table 

The  expanded  retention  table  is  a  sequential  data  set  that  contains  control 
statements  defining  specifications  for  automatic  retention  of  SYSOUT.  The  data 
set  is  allocated  to  the  CA-View  archival  started  task  with  the  SARPATAB  DD 
statement.  See  Chapter  6,  "Expanded  Retention  Option,"  for  a  complete 
description. 


Attributes 


DCB  attributes  for  the  file  are: 

RECFH=F  or  FB 

LRECL=80 

BLKSIZE=iinnnn 


where  nnnnn  is  a  multiple  of  80. 


Environmental  Considerations 

The  following  variables  should  be  considered  when  establishing  an  operating 
environment  for  CA-View  Release  2.0. 

CA-Spool  CA-Spool  must  be  at  Release  9  with  the  CA-SpoolPTF  ST-09171  applied  for 

CA-View  2.0  to  run  properly. 
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CA-Deliver  Whem  mnning  GA-View  2.0  im  conjunction  with  GA-Deliver,  note  the  following: 

■  You  must  be  running  GA-Deliver. 

■  When  printing  through  GA-View  VTAM  print>  GA-Deliver  reports  can  be 
printed;  however  bimdles  cannot  be  printed. 

CA-DocView  GA-View  Workstation  version  1.4  or  higher  is  required  to  view  reports  from 

(Formerly  CA-View  GAWiew  2.0. 

Workstation); 

Note:  GA-View  Workstation  has  been  renamed  toGA-DocView. 


Interfaces  and  Output  Functions 


The  following  table  indicates  whether  a  GA-View  2.0  interface,  listed  in  the  leftr 
most  column>  works  in  conjunction  with  a  GA-View  2.0  output  function: 


Online 

Interface/ 

Function 

CA-View 

VTAMPrini 

CA-Spool 

PC 

Download 

Double- 

Byte 

Characters 

TSO 

Yes 

Yes 

Yes 

Yes 

ISPF 

Yes 

Yes 

Yes* 

Yes 

VTAM 

Yes 

Yes 

Yes 

No 

GA-Roscoe 

Yes 

Yes 

Yes 

No 

GIGS  Gross- 
memory 

No 

Yes 

Yes 

No 

IMS 

No 

Yes 

Yes 

No 

GMS 

No 

No 

Yes 

No 

Batch 

Yes 

Yes 

Yes 

Yes 

Optical  Disk  Interface  The  optical  disk  interface  for  GA-View  2.0  is  not  available  under  the  VM/GMS 
online  retrieval  interface. 


AFP  Reports: 
Archiving  and 
Viewing 


Online  Filters 


The  GA-View  AGIF  interface,  which  archives  AFP  reports  to  the  GA-View 
database,  requires  the  following: 

■  IBM  PSF/MVS  2.1.1  or  higher  (Print  Services  Facility) 

■  SAR  Version  6.5  or  higher,  or  GA-View 


Greating  filters  for  online  viewing  requires  ISPF  3.5  or  above. 
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Troubleshooting  and  Technical  Support 


In  This  Appendix 

This  appendix  explains  how  to  troubleshoot  problems,  obtain  customer  support, 
and  request  product  enhancements.  The  following  topics  are  discussed: 

■  Diagnostic  procedures 

■  Troubleshooting 

■  Collecting  diagnostic  data 

■  Accessing  the  StarTCC  online  support  system 

■  Calling  Computer  Associates  Technical  Support 

■  Sending  documentation  to  Computer  Associates  Technical  Support 

■  Product  releases  and  maintenance 

■  Requesting  product  enhancements 


Diagnostic  Procedures 

The  flowchart  that  follows  summarizes  the  procedures  to  use  if  you  have  a 
problem  with  a  Computer  Associates  software  product.  Each  of  these  procedures 
is  detailed  on  the  following  pages. 
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Diagnostic  Procedures 


Problem  Diagnosis  Flowchart 
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Troubleshooting 

Before  contacting  Computer  Associates  Technical  Support,  attempt  to  resolve  the 

problem  yourself  by  doing  the  following: 

1.  Review  the  troubleshooting  flowchart  in  the  previous  section  for  general 
debugging  suggestions. 

2.  Review  the  activities  you  performed  when  the  problem  occurred,  comparing 
them  to  the  documented  procedures. 

3.  If  you  performed  all  procedures  correctly,  repeat  the  activity  under 
conditions  similar  to  those  that  existed  when  the  problem  first  appeared.  (If 
the  results  are  satisfactory,  an  inadvertent  error  may  have  caused  the 
problem.) 

4.  If  the  error  recurs  when  you  repeat  a  given  activity,  and  you  can  find  nothing 
in  the  documentation  to  suggest  that  your  procedure  may  be  flawed,  try  to 
get  help  from  others  at  your  site. 


Collecting  Diagnostic  Data 

This  section  identifies  some  potential  problem  areas  and  presents  debugging 
suggestions;  it  also  lists  the  documentation  to  have  on  hand  when  you  call 
Computer  Associates  Technical  Support. 


System  Crash 

If  an  abend  occurs  that  brings  down  the  operating  system;  do  the  following: 

1.  Refer  to  the  operating  system  documentation  for  the  various  system  dump 
formats  that  can  be  produced  for  diagnostic  purposes. 

2.  Check  for  operating  system  messages  or  return  codes  and  follow  the 
procedures  for  recovery  that  are  documented  in  the  IBM  MVS  system  and 
message  code  documentation. 

3.  Initiate  the  restart  procedures  documented  in  the  IBM  MVS  system  and 
message  code  documentation. 

Documentation  Have  the  following  on  hand  when  you  caU  Computer  Associates  Technical 

Support: 

■  A  completed  Support  Contact  Information  form  (see  the  section  Support 
Contact  Information  Form  later  in  this  appendix) 

■  Product  release  and  maintenance  levels 
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■  System  release  and  maintenance  levels 

■  System  and/or  application  logs 

■  Recent  changes  or  upgrades 

■  System  and/ or  application  dumps 


Application  Problems  or  Errors 


If  you  have  a  problem  witii  an  application  program;  or  it  terminates  abnormally, 

do  the  following: 

1.  If  your  system  abended,  see  the  appropriate  IBM  system  messages  and  codes 
documentation. 

2.  If  you  received  an  inappropriate  return  code,  review  the  procedure  you  used, 
then  review  the  return  code  description  for  the  recommended  action  in  the 
IBM  MVS  system  messages  and  codes  documentation. 

3.  If  you  have  a  problem  with  a  system  or  operator  function,  collect  the  dump 
or  screen  print,  if  appropriate. 

4.  Check  all  system  and  application  logs  for  applicable  messages. 

5.  If  the  current  maintenance  tape  has  not  been  applied,  check  the  information 
member  for  an  applicable  solution  or  access  StarTCC  online.  (See  Accessing 
the  StarTCC  Online  Support  System  later  in  this  appendbc.) 


Documentation  Have  the  following  on  hand  when  you  call  Computer  Associates  Technical 

Support: 

■  A  completed  Support  Contact  Information  form  (see  the  section  Support 
Contact  Information  Form  later  in  this  appendix) 

■  Error  messages 

■  Return  codes 

■  Product  release  and  maintenance  levels 

■  System  release  and  maintenance  levels 

■  System  and/or  application  logs 

■  Complete  problem  description  and  procedures  for  recreating  the  problem 
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■  Recent  changes  or  upgrades 

■  System  and/or  application  dumps 


Performance  Problems 

If  you  have  a  performance  problem,  which  is  indicated  by  slow  online  response 

time  or  slow  batch  job  processing,  do  the  following: 

1.  Try  to  determine  whether  the  problem  is  associated  with  a  single  job  or  with 
an  environmental  problem; 

2.  If  the  current  maintenance  tape  has  not  been  applied,  check  the  information 
member  for  an  applicable  solution  or  access  StarTGC  online.  (See  Accessing 
the  StarTCC  Online  Support  System  later  in  this  appendix.) 


Interpreting  Diagnostic  Data 

When  you  have  collected  the  specified  diagnostic  data,  write  down  your  answers 
to  the  following  questions: 

1 .  What  was  the  sequence  of  events  prior  to  the  error  condition? 

2.  Can  the  problem  be  recreated  at  will? 

3.  What  circumstances  existed  when  the  problem  occurred,  and  what  action  did 
you  take? 

4.  Has  this  situation  occurred  before?  What  was  different  then? 

5.  Did  the  problem  occur  after  a  particular  RTF  was  applied  or  after  a  new 
release  of  the  software  was  installed? 

6.  Have  you  recently  installed  a  new  release  of  the  operating  system? 

7.  Has  the  hardware  configuration!  (tape  drives,  disk  drives,  and  so  forth) 
changed? 

From  your  response  to  these  questions  and  the  diagnostic  data,  try  to  identify  the 
cause  and  resolve  the  problem. 

If  you  determine  that  the  problem  is  the  result  of  an  error  in  a  Computer 
Associates  software  product,  you  can  use  CA-TCC  to  see  if  a  fbc  (AFAR  or  PTF) 
or  other  solution  has  been  published,  then  call  Computer  Associates  Technical 
Support. 
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Accessing  the  StarTCC  Online  Support  System 

To  complement  standard  technical  support,  Computer  Associates  offers  extended 
real-time  support  via  StarTGC  on  the  Ihtemet.  Using  StarTCC,  which  you  access 
from  the  Computer  Associates  Home  page  on  the  World  Wide  Web,  you  can: 

■  Download  fixes 

■  Commumcate  with  Computer  Associates  Technical  Support  on  existing 
issues 

■  Open  new  issues 

■  Search  for  solutions  and  problems 

To  access  StarTCC,  do  the  following: 

1.  Point  your  Web  browser  to  the  Computer  Associates  Home  page  at 
http://www.caiicom. 

2.  Select  Support  to  display  the  Service  and  Support  page,  then  click  CA  Total 
Client  Care. 

3.  Do  one  of  the  following: 

■  To  register,  click  the  CA-TCC  Registration  link. 

■  To  access  StarTCC,  click  the  Access  CA-TCC  (registered  clients  only) 
link. 

You  must  have  a  Web  browser  that  supports  HTML  2.0  or  higher,  such  as 
Netscape  Navigator  2.0  or  higher  or  Microsoft's  Internet  Explorer  3.0  or  higher. 
These  browsers  support  the  following  functions  required  for  StarTCC: 

■  Secure  sockets  layer  (SSL)  for  encrypting  transaction  traffic  between  you  and 
Computer  Associates 

■  "Cookies" — encrypted  data  records  required  by  StarTCC 

■  HTML  tables 


Calling  Computer  Associates  Technical  Support 

Computer  Associates  provides  telephone  support  for  all  of  its  products.  Refer  to 
the  Computer  Associates  Product  Support  Directory  ioT  the  telephone  number  and 
refer  to  the  section  Where  to  Call  for  Support  later  in  this  appendix.  To  expedite 
problem  resolution>  assemble  all  recommended  information  before  placing  the 
call. 
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When  to  CalilTechnical  Support 

If  you  have  a  current  maintenance  agreement  with  Computer  Associates,  you  can 
contact  Computer  Associates  Technical  Support  to: 

■  G^en  a  new  issue 

■  Address  an  open  issue 

■  Reopen  a  closed  issue 


Opening  a  New  Issue 


Open  an  issue  when  you  have  identified  one  or  more  of  the  following  types  of 
problems  but  have  not  been  able  to  resolve  them: 

■  A  problem  with  CA-View 

■  A  problem  related  to  CA-View's  coexistence  with  other  software  products 

■  Site-specific  solutions  you  may  require 

■  A  problem  determining  how  to  use  a  CA-View  feature  for  a  site-specific 
purpose 

■  A  problem  with  documentation,  including  errors,  omissions,  or  incomplete 
explanations  or  procedures 


Addressing  an  Open  Issue 

Contact  Computer  Associates  Technical  Support  on  a  previously  opened  issue  to: 

■  Provide  new  information  on  an  open  issue 

■  Inquire  about  the  status  of  an  open  issue 

■  Revise  the  problem  severity  rating  (see  Describing  the  Problem  later  in  this 
appendix) 

■  Inform  Computer  Associates  Technical  Support  that  you  solved  an  open 
issue,  and  how  you  solved  it 


Reopening  A  Closed  Issue 

If  the  original  problem  recurs,  you  can  reopen  a  closed  issue.  Be  sure  to  identify 
the  issue  by  its  original  contact  number. 
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Preparing  to  Call  About  a  New  Issue 


Before  you  calli  prepare  the  following: 

■  A  photocopy  of  the  Support  Contact  Information  form  (see  the  section 
Support  Contact  Infoncnation  Form  later  in  this  appendix)  with  all  available 
information  logged 

■  A  Support  Contact  Number  Log  with  the  date  of  the  call  recorded  in  the  Date 
Opened  field  (see  the  section  Support  Contact  Number  Log  Form  later  in  this 
appendix) 

■  A  history  of  the  problem 

■  AU  available  diagnostic  data  (see  the  section  Collecting  Diagnostic  Data 
earlier  in  this  appendix) 

The  person  caUing  Computer  Associates  Technical  Support  should  be  generally 
familiar  with  CA-View,  the  current  release,  the  current  maintenance  level,  the 
details  of  the  problem  reported;  and  the  various  options  and  features  in  use;  or 
s/he  should  have  immediate  access  to  someone  who  has  this  information. 


Preparing  to  Call  About  an  Open  Issue 

When  you  call  Computer  Associates  Technical  Support  about  an  open  issue,  refer 
to  the  issue  by  contact  number,  not  by  the  name  of  the  technician  with  whom  you 
previously  spoke.  The  issue  may  have  been  transferred  to  a  different  group 
mtemally,  and  a  new  technician  may  have  assumed  responsibility  for  further 
action  on  the  issue.  All  prior  history  of  the  contact  is  retained  in  ttie  Computer 
Associates  Technical  Support  tracking  and  reporting  system  under  that  contact 
number,  so  the  technician  has  immediate  access  to  it. 

Before  you  caU'  have  the  following  available: 

■  The  Support  Contact  Information  form  containing  the  CA-supplied 
information: 

-  The  name  of  the  Computer  Associates  Technical  Support  technician 

-  Contact  number 

-  Issue  number  (if  there  is  more  than  one  issue  associated  with  the  contact 
number) 


B-8  CA-View  System  Reference  Guide 


Calling  Computer  Associates  Technical  Support 


-  Solution  number,  if  provided 

-  Your  CA  site  HD 

Note:  If  you  no  longer  have  the  Support  Contact  Information  form,  look  up 
the  contact  number  recorded  on  your  Support  Contact  Number  Log  form. 

■  A  brief  description  of  the  nature  of  this  call. 


Preparing  to  Reopen  a  Closed  Issue 

If  a  previous-resolved  problem  recurs,  contact  Computer  Associates  Technical 
Support  to  have  the  issue  reopened.  Please  refer  to  the  original  contact  number 
so  that  all  historical  information  is  available  for  diagnosis. 

Before  you  caU>  have  the  following  available: 

■  The  original  contact  number  and  solution  (if  available) 

■  A  history  of  the  problem  and  resolution 

■  All  available  diagnostic  data  (see  the  section  Collecting  Diagnostic  Data 
earlier  in  this  appendix) 


Where  to  Call  for  Technical  Support 

If  you  are  in  North  America,  refer  to  the  Computer  Associates  Product  Support 
Directory  for  the  Computer  Associates  Technical  Support  phone  number  and 
hours  of  operation.  Outside  North  America,  call  your  local  Computer  Associates 
Support  Center  during  normal  business  hours. 

Note:  Only  your  local  Computer  Associates  Support  Center  can  provide  native 
language  assistance.  Please  speak  English  when  contacting  any  North  American 
center. 

Emergency  phone  numbers  are  available  for  after-hours  technical  support:  Ini 
North  America  call  1-800*645-3042.  Outside  North  America,  call  the  Computer 
Associates  Technical  Support  phone  number  listed  in  the  Computer  Associates 
Product  Support  Directory,  AU  after-hours  calls  should  be  limited  to  severity  1 
problems.  (See  the  following  section.  Describing  the  Problem.) 
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If  you  are  unable  to  locate  the  technical  support  number  you  need,  call 
1-800+645-3042  for  assistance  if  you  are  in  North  America  or  516-342-4683  outside 
North  America.  The  operator  will  record  your  call  and  a  Computer  Associates 
Technical  Support  technician  will  call  you  back. 


Describing  the  Problem 


Problem  Severity 
Rating 


Do  the  following  before  calling  Computer  Associates  Technical  Support: 

1.  Identify  the  context  in  which  the  problem  occurred  (for  example,  a  problem 
with  installation  or  a  problem  in  the  production  environment). 

2.  If  this  is  a  new  installation;  product  upgrade,  pilot  project,  or  problem  with  a 
test  system,  list  the  steps  you  followed  up  to  tins  point. 

3.  If  the  problem  occurred  in  a  production  environment,  describe  the  following 
in  detail: 

■  The  attempted  activity,  with  the  expected  results  and  actual  results 

■  The  attempts  to  resolve  the  problem  and  their  results 

Note:  The  very  act  of  producing  an  accurate  description  of  the  problem  may 
suggest  its  cause  and  perhaps  a  way  to  correct  it.  If  not,  an  accurate 
description  will  assist  the  Computer  Associates  Technical  Support  technician 
in  helping  you  to  resolve  it. 

4.  Prioritize  the  problem. 

Computer  Associates  uses  a  rating  system  to  expedite  resolution  of  support 
calls.  Use  the  following  guide  to  establish  the  severity  of  your  problem: 


Severity 

Description 

1 

Production  system  down  or  major  business  impact 

2 

Major  component  nonfunctional  or  serious  business  impact 

3 

Minor  component  noiifunctional  or  moderate  business 
impact 

4 

General  question  or  a  noncritical  problem 
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5.  Photocopy  the  following  forms  (located  later  in  this  appendix)  and  complete 
the  applicable  sections; 

■  Support  Contact  Information  form 

Prior  to  making  the  call,  use  this  form  to  record  all!  the  infonnation 
required  by  the  Computer  Associates  Technical  Support  technician. 
During  the  call,  use  this  form  to  record  all  the  information  the  technician 
provides.  (See  the  section  Support  Contact  Ihfonnation  Form  later  in  this 
appendix.) 

■  Support  Contact  Number  Log  form! 

Use  this  form  to  keep  a  permanent  record  of  the  contact  numbers 
associated  with  the  issues  about  which  you  contact  Computer  Associates 
Techiucal  Support.  If  an  issue  diat  has  been  closed  reappears  due  to 
incomplete  resolution,  this  form  can  serve  as  a  reference  of  the  original 
contact  number  so  that  the  technician  can  reactivate  the  appropriate  file. 
(See  the  section  Support  Contact  Number  Log  Form  later  in  this 
appendix.) 


Making  the  Call 


When  you  call!  Computer  Associates  Technical  Support,  you  are  connected 
directly  to  a  technician  for  CA-View.  If  no  CA-View  technician  is  available,  your 
call  will  be  answered  by  a  technical  administrator  who  will  record  your  problem 
in  the  Computer  Associates  Technical  Support  tracking  system. 

All  calls  are  returned  in  the  order  received  and  by  degree  of  severity.  The  next 
available  technician  will  return  your  call  as  soon  as  possible. 

1.  Provide  the  Computer  Associates  Technical  Support  technician  with  the 
following  information: 

■  Your  CA  site  ID  and  PIN  number,  if  known 

■  The  severity  rating  of  your  problem 

■  Your  company  information  (see  the  section  Support  Contact  Information 
Form  later  in  this  appendix) 

■  A  brief  description  of  the  problem 
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Note:  When  you  call  about  a  new  issue,  do  not  refer  to  a  contact  number 
previously  assigned  for  a  different  issue;  this  could  impede  the  resolution  of 
your  current  problem. 

If  you  do  not  know  your  CA  site  ID  or  are  not  certain  what  the  problem! 
severity  code  should  be,  the  technician  will  provide  this  information.  Record 
the  site  ID  and  severity  level  on  the  Support  Contact  Information  form. 

2.  When  the  technician  enters  your  issue  in  the  Computer  Associates  Technical 
Support  tracking  system,  record  the  information  provided  by  the  technician 
on  the  Support  Contact  Information  form. 

This  information  will  indude  a  contact  number  and,  if  you  address  multiple 
issues,  the  issue  numbers. 

3.  The  technician  may  reqtrest  that  you; 

■  Provide  additional  detailed  information 

■  Forward  applicable  diagnostic  documentation 

■  Perform  troubleshooting  procedures  as  directed 

■  Relate  site-specific  environmental  information 

4.  If  a  solution  is  determined  during  the  initial  call,  record  the  solution  on  the 
Support  Contact  Information  form.  Also,  be  sure  to  record  the  current  date 
imder  Date  Closed  on  the  Support  Contact  Number  Log  form. 


if  the  Problem  is  Not  Resolved  immediately 

1.  If  the  problem  cannot  be  resolved  immediately  over  the  phone,  the  technician 
may  provide  a  solution  number  and  advise  you  to  expect  the  solution  in  the 
form  of  a  module  replacement,  ZAP,  or  source  change. 

The  solution  wiU  be  supplied  to  you  by  one  of  the  following  methods: 

■  Via  telephone,  FAX,  telex,  or  mail 

■  On  a  maintenance  or  product  tape 

■  Through  one  of  the  online  client  support  systems 

2.  If  a  solution  is  not  readily  available,  the  technician  may  require  additional 
documentation  and/or  ttiat  more  testing  be  performed. 
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Whenever  possible,  the  technician  will  attempt  to  reproduce  the  problem  in- 
house  to  obtain  diagnostic  data.  If  the  problem  is  not  reproducible  due  to 
environmental  factors,  you  will  be  asked  to  provide  diagnostic  information  to 
the  technicianior  analysis.  To  expedite  problem  resolution  please  provide  rs 
much  detail  as  possible. 

As  soon  as  a  solution  is  available,  it  will  be  provided  by  one  of  the  methods 
listed  in  Step  1. 

3.  If  the  solution  resolves  the  problem)  record  the  date  of  resolution  under  Date 
Closed  on  the  Support  Contact  Number  Log  form;  otherwise,  continue  the 
dialog  with  the  technician  until  the  problem  is  resolved. 


Sending  Documentation  to  Computer  Associates  Technicai 
Support 


Use  the  following  guidelmes  when  the  Computer  Associates  Technical  Support 
technician  requests  dumps,  trace  listings,  compile  lists,  or  other  docxunentation 
related  to  an  open  issue; 

1.  Write  the  contact  and  issue  numbers  prominently  on  each  listing. 

2.  Include  a  photocopy  of  the  completed  Support  Contact  Information  form  for 
this  issue. 

3.  Address  the  package  to  the  CA-View  support  center.  Obtain  the  address 
from  your  Computer  Associates  representative  or  consult  the  Computer 
Associates  Product  Support  Directory. 


Sample  Forms 


The  forms  on  the  following  pages  are  designed  to  help  you  keep  an  accurate 
record  of  your  contacts  with  Computer  Associates  Technical  Support.  Refer  to 
these  forms  when  making  calls.  For  example,  use  the  Support  Contact  Number 
Log  form  to  record  the  issues  associated  with  a  contact  number.  When  issues  are 
resolved  (closed),  enter  tib.e  date  in  the  last  column.  If  a  closed  problem  recurs, 
refer  to  this  log  for  its  contact  number  so  that  the  appropriate  file  can  be 
reactivated.  You  can  phofeocopy  these  forms  as  needed. 
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Sending  Documentation  to  Computer  Associates  Technical  Support 


Support  Contact  Information  Form 

General  Information: 

Support  Telephone  Number  ( 

SUPPORT  CONTACT  INFORMATION 

) 

Date  of  Call: 

Problem  Severity: 

CA-Supplied  Information: 

Support  Technician: 

Contact  Number: 

Fax  Number:  (  T 

Issue  Number: 

Your  CA  Site  ID: 

Your  CA  PIN  Number: 

Solution  Number: 

for  Product: 

Release: 

Your  Company  Information: 

Company  Name: 

Location: 

Your  Name: 

Telephone  Number:  (  1 

Extension: 

Fax  Number:  (  ) 

Alternate  Contact  Person: 

Alternate  Telephone  Number:  ( 

) 

Extension: 

Notes: 

Page  1  of  2 
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Support^  Contact  Information  Form  (Continued) 


SUPPORT  CONTACT  INFORMATION 
Product  Releases  and  Maintenance  Levels: 

Product  Release  Maintenance 

CA-View  _  _ 

Operating  System  _  _ 

CA90S  Services  _  _ 

Other  _  _ 

Other  _ 


Additional  solutions  applied: 

Product  Solution  Numbers 
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Product  Releases  and  Maintenance 

New  users  of  GA-View  are  provided  with  a  distributioir  tape  containing  the 
current  version  of  the  system.  Clients  are  requested  to  operate  only  under 
currently  supported  rel^ses  of  CA-View. 

Standard  user  documentation  is  also  provided  to  CA-View  users.  Updates  to  this 
documentation  are  provided  automatically  to  alii  clients  having  current 
maintenance  agreements. 

Clients  with  current  maintenance  agreements  also  receive  ongoing  CA-View 
maintenance.  When  a  new  release  of  the  system  is  available,  a  notice  is  sent  to  aU 
current  CA-View  chents- 


Requesting  Product  Enhancements 

Computer  Associates  welcomes  your  suggestions  for  product  enhancements.  All 
suggestions  are  considered  and  acknowledged.  Contact  your  Account  Manager 
who  will  initiate  a  Demand  Analysis  Request  (DAR)  for  you. 

The  DAR  system  serves  as  a  central  receiving  point  for  aU  enhancement  requests. 
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extracting  from  SMF,  3-11 
formatting,  3-14 
SARACTUX  user  exit,  3-11 
SMF  type-6  records,  3-11 
file,  description  and  attributes,  A-7 
report  program,  3-9 
executing,  3-10 

overview.  See  also  accounting  data 

AGF2 

bypassing  password  verification,  3-31 
parameter,  2-2 
protection,  3-29 
security  checking,  2-2, 2-3 

AGF2SCG  parameter,  2-3 

AGIF 

archival  task  exit — SARAGFUX,  11-5 

archival,  starting,  5-9 

archival,  stopping,  5-9 

archiver,  5-9 

control  statements,  5-11 

AGIFRES  parameter,  2-3 

ADDDS  statement,  7-5 

ADDLGGK  statement,  7-7 

AFP  reports 

and  embedded  resources,  2-3 
archiving,  5-9 
indexing,  5-10 
viewing,  5-10 


ALL  (ERO  parameter),  6-4 
AMASPZAP  utility,  3-17 
ANNOTATE  parameter,  2-3 
armotations,  8-2 
application  errors,  B-4 
archival 

automatic,  3-32, 5-31 
and  GA-Deliver,  3-32 
user  exit,  11-7 
data  sets,  A-4 
direct-to-tape,  5-5 
duplex  data  set,  A-5 
generations,  5-5 
of  AFP  reports,  5-9 
of  JGL  listings,  5-7 
of  report  SYSOUT,  5-8 
ofSYSLOG  data,  5-9 
of  Xerox  reports,  5-14 
processing  without,  5-6 
selecting  SYSOUT  for,  2-5 
selecHon  criteria  for,  5-1 
tape  consolidation  user  exit,  11-18 
tape,  unloading,  5-29 

archival  tasks 

running  as  batch  job,  5-32 
running  multiple,  5-30 
starting,  5-27 
stopping,  5-28 

user  exit  for  modifying,  11-24 
ARGHMSG  parameter,  2-3 
ARGHSWAP  parameter,  2-4 
authority,  setting  master,  2-18 
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B 

backup  cycle 

automatic  initiation  of,  2-6 
holding  SYSOUT  for,  2-15 
interim,  5-3 

setting  interval  for,  2-16 
stacked,  2-28 
standard,  5-3 
user  exit,  11-11 

backups 

of  annotations,  8-2 
overview,  8-2 
report  listing  of,  5-3 
setting  number  of  interim,  2-21 
specifying  options  for,  2-33 

banner  page  user  exit,  11-20 

batch  processing,  9-1,  A-9 

BCHMAXRG  parameter,  2— 4 

SPRINT  control  statement,  9-6 

browsing  reports  on  tape.  See  expanded  access  server 

bundles,  reprinting  CA-Deliver,  9-6 


c 

GA-Balancing 
database,  4r-8 
extracted  data  from,  9-1 
extracted  fields,  9-21 

G  A-Deliver,  A-9 

and  automatic  report  archival,  3-32 
bundle  reprinting,  9-6 
direct-to-CA-View 

block  allocation,  2-9 
cleanup  processing,  2-5 
reports,  printing,  9-17 

GA-DocView,  1-5,  A-9 

GANGEL  command,  4-8 

GA-Rbscoe,  A-9 
and  RAGF,  3-27 
cross-memory  services,  4-4 
online  retrieval  facility,  4-4 

GA-Spool,  A-8 

printing  with,  2-6 
setting  line  limits  for,  2-5 


GA-View  Workstation.  See  GA-DocView 

GGONDISP  parameter,  2—4 

GHANGE  control  statement,  9-7 

characters,  setting  default  carriage  control,  2-4 

GHKPT  macro;  5-31 

GIGS 

and  RAGF,  3-27 
cross-memory,  A-9 

cross-memory  connect  ID  user  exit,  11-2 
online  retrieval  facility,  4-5 

classes 

in  Print  Attribute  panel,  2-34 
printed  by  GA-View,  2-24 
setting  for  SYSOUT  printing,  2-16 
to  archive  to  tape,  2-32 
to  be  processed  by  GA-View,  2-21, 2-22 

GLEAN  parameter,  2-5 

cleanup  processing,  2-5, 5-29 

GLOSE  command,  4-9 

GLSL  parameter,  2-5 

GMAMAX  parameter,  2-5 

GMASPOOL  parameter,  2-6 

GMS,A-9 

codepage  default  parameter,  2-6 

GODEPAGE  parameter,  2-6 

COMM  parameter,  3-4 

condition  checking.  See  exceptional  condition 
checking 

control  block  mapping  user  exit,  11-16 
copies,  of  SYSOUT  to  maintain,  2-41 
COPY  statement,  7-8 
cross-memory 

connection  ID  user  exits,  11-2 
services 

CA-Rbscoe,  4-4 
GIGS,  4-5 
ISPF,4-3 
TSO,  4-2 
task,  4-7 

canceling  users  from,  4-8 
closing,  4-9 

listing  statistics  for,  4-10 
normal  termination,  4-7 
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cross-memory 

task  (Continued) 
opening,  4-10 
shutting  down,  4-7 
starting,  4-7 

suspending  users  from,  4-9 
customer  support, 


D 

database 

backup 

and  recovery  overview,  8-1 
by  third-party  software,  8-8 
guidelines,  8-3 
capacity  threshold,  2-7 
copying  a,  7-8 
creating  a  new,  7-5 
deleting  a,  7-9 
description  of,  A-1 
displaying  statistics  on,  7-16 
initializing  for  online  viewing,  7-16 
loading  a,  7-9 
locking,  7-2, 7-7 
master  index,  7-9,  A-2 
merging  a,  7-10 
optical  disk  maintenance,  10-22 
recovery 

from  integrity  problems,  8-11 
from  media  problems,  8-9 
guidelines,  8-3 
procedures,  8-7 
utilities,  8-6 
renaming  a,  7-13 
reorganizing  a,  7-13 
restoring  a,  7-15,  7-27 
setting  the  version  of  the,  7-20 
specifying 

a  name  for,  7-12 
high-level  name  of,  2-21, 9-11 
unloading  a,  7-19 
unlocking  a,  7-19 

database  access  method,  7-41 
SAMCEOSE  routine,  7-44 
SAMGET  routine,  7-44 
SAMINVL  routine,  7-46 
SAMMSG  routine,  7-47 
SAMOPEN  routine,  7-43 
SAMSCLS  routine,  7-50 
SAMSGET  routine,  7-49 
SAMSOPN  routine,  7-48 


database  access  method  ( Continued) 
SARSAM  routine,  7-51 

database  maintenance,  7-2 
ADDDS  statement,  7-5 
ADDLOCK  statement,  7-7 
control  statements,  7-4 
COPY  statement,  7-8 
DELETE  statement,  7-9 
IDXOUT  statement,  7-9 
LOAD  statement,  7-9 
MERGE  statement,  7-10 
NAME  statement,  7-12 
OLOAD  statement,  7-12 
RENAME  statement,  7-13 
REORG  statement,  7-13 
RESTORE  statement,  7-15 
SET  statement,  7-16 
STATUS  statement,  7-16 
UNLOAD  statement,  7-19 
UNLOCK  statement,  7-19 
VERIFY  statement,  7-20 
VERSION  statement,  7-20 

date  format,  3-1 

DAYS  parameter,  2-6 

DBASE  control  statement,  9-11 

DBMODE  parameter,  2-7 

DBMSGFRQ  parameter,  2-7 

DBTHRESH  parameter,  2-7 

DCOPIES  parameter,  6-5 

DEF  DEV  command,  3-18 

DEFDIST  control  statement,  9-11 

DEFSYS  control  statement,  9-12 

DEFUSER  control  statement,  9-13 

DELETE  control  statement,  9-15 

DELETE  parameter,  2-8, 6-9 

DELETE  statement,  7-9 

DESC  parameter,  2-8 

DEST  parameter,  2-8 

destination 

specifying  for  SYSOUT,  2-8 
user  exit,  11-12 

device-specific  user  exit,  11-3 

DFQUIDLE  parameter,  3-5 
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DGENS  parameter,  6-5 

diagnostic  procedures,  B-1 

DIRALLOC  parameter,  2-9 

disk  restore,  7-36 

control  statements,  7-37 
TADD  statement,  7-38,  7-39 

disk  retention,  6-5 

DCOPIES  parameter,  6-5 
DGENS  parameter,  6-5 
DRETPD  parameter,  6-5 
IRETPD  parameter,  6-5 
LRETPD  parameter,  6-6 

DIST  ID,  creating  SYSOUT  IDs  for,  9-11, 9-12 

double-byte  character  sets  (DECS),  1-5 

downloading  to  PC,  1-5 

DRETPD  parameter,  6-5 

drivers 

FileTek,  10-18 

IBM  DASD  emulation,  10-21 
Kodak  Optistar,  10-16, 10-17 
0AM,  10-19 

page  level  for  optical  disk,  10-6, 10-7, 10-8, 
10-17, 10-18 

report  level  for  optical  disk,  10-8, 10-16 
setting  for  optical  disk  storage,  10-6 

DSK2DAYS  parameter,  2-38,  6-8, 10-9 

DSBC2DRVR  parameter,  2-39 

DSK2INTV  parameter,  2-39, 10-13 

DSK2MIGD  parameter,  2-39, 10-12 

DSK2NOTP  parameter,  6-8;  10-10 

DSK2TIME  parameter,  2-39, 10-12 

duplex  tape,  7-30, 7-31,  A-5 

DVS  archiver,  5-14 
starting,  5-14 
stopping,  5-14 

DVS  Xerox  archival  task  user  exit — SARDVSUX, 
11-13 


E 


E22GICUX  (GIGS/ cross-memory  user  exit),  11-2 


E22xxxUX  (GIGS/ cross-memory  connection  ID  user 
exit),  11-2 

EAS.  See  expanded  access  server 
EASTDPLX  parameter,  2-9 
EASTMAXW  parameter,  2-9 
EASTNAMl-3  parameters,  2-10 
environmental  considerations,  A-8 
EPRINT  control  statement,  9-17 
ERO 

and  exceptional  conditions,  2-43 
assigiung  SYSOUT  to,  2-41 
expiration  parameters  for,  2-42 
iiutialization  parameters,  2-38 
overview  of,  6-1 
specifying  use  of,  2-40 
SYSOUT  for,  2-40 

ERO  table,  6-1 

description  and  attributes,  A-8 
examples,  6-10 
parameters,  10-9 
DSK2DAYS,  10-9 
DSK2NOTP,  10-10 
statements,  6-2, 6-3  to  6-10, 6-3 
updates,  6-2 

EROOPT  parameter,  2-40 

EROPRO  parameter,  2-40 

error  messages,  descriptions,  12-1 

errors,  application,  B-4 

exceptional  condition 
checking,  5-6,  5-19 

message  routing,  2-27 
overview,  1-2 
refreshing  parameters,  5-30 
SARSTG99  message,  5-29 
user  exit,  11-30 
coding,  5-20 
included  in  ERO,  2-43 
list,  5-19 
messages,  2-8 

processing  (XGOND  parameter),  6-9 
table,5-19 

description  and  attributes,  A-8 
user-specified,  5-24 

expanded  access  server,  3-2 
GOMM  parameter,  3-4 
DFQUIDLE  parameter,  3-5 
EASTNAMl-3  parameters,  2-10 
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expanded  access  server  (Continued) 
EASTNAME  parameter,  3-5 
implementing,  3-4 
internals,  3-3 

LSERVNAME  parameter,  3-5 
MAXIDLE  parameter,  3-5 
MINIDLE  parameter,  3-5 
MOUNT  parameter,  3-6 
NBUF  parameter,  3-6 
NREAD  parameter,  3-6 
NREQ  parameter,  3-6 
NTHREADS  parameter,  3-6 
optimizing  performance,  3-7 
referencing  multiple,  2-10 
SAREASUX  exit,  11-14 
start-up  parameters,  3-4 
TYPE  parameter,  3-7 

expanded  retention.  SeeERO 

Expanded  Retention  Option.  See  ERO 

EXPDT  parameter,  2-10 

EXPERTn  parameter,  3-18 

EXPRESS  parameter,  2-11 

EXPRTn  parameter,  2-12 

EXTERNAL  device 
defining,  3-18 

external  printing 

dynamic  program  call,  3-20 
interface,  3-17 
JES  data  set  interface,  3-18 
setting  attributes  for,  2-12 

external  security  interface,  3-24 

EXTPRTn  parameter,  3-18, 3-20 

EXTRACT  control  statement,  9-21 


F 


FileTek 

drivers,  10-18 

page-level  drivers,  10-8, 10-18 
FINDLAST  parameter,  2-13 
FINDLIM  parameter,  2-13 
FINDPREV  parameter,  2-14 


FORM  parameter,  2-14 


forms,  specifying  name  for,  2-22 

forward  recovery  data  sets,  8-3 
activating,  ^5 
allocating,  2-26 
description  and  attributes,  A-6 
messages,  8-5 
operation,  8-4 

specifying  primary  space,  2-25 
specifying  secondary  space,  2-26 

Functional  Subsystem  (FSS),  5-14 

Functional  Subsystem  Interface  (FSI),  5-14 


G 


generations,  5-5 

maintained  on  disk,  2-23 
maintained  on  tape,  2-23 

GREXX  variables,  9-3 

GSS  interface  and  SARBCH,  9-2 


H 


HOLDTEMP  parameter,  2-15 


IBM 

DASD  emulation  drivers,  10-21 
page-level  drivers,  10-6, 10-7 

IDXOUT  statement,  7-9 

IMS,A-9 

and  ACF2, 3-30 
and  RACF,  3-27 
and  VTAM  printing,  4-6 
online  interface  transaction,  4-5 

INDEX  control  statement,  9-22 

indexing 

AFP  reports,  5-10 
Xerox  reports,  5-15 
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initialization  parameters,  2-1 
description,  2-2 
examples,  2-44 
format,  2-2 

INTERVAL  parameter,  2-16 

IRETPF  parameter,  6-5 

ISPF,  A-9 

and  ACF2, 3-30 
and  RACF,  3-27 
cross-memory  services,  4-3 
online  retrieval  facility,  4-2 


J 

J  selection  code,  2-16 

JCLASS  parameter,  2-16 

JES2,  setting  default  level,  2-16 

JES2LVL  parameter,  2-16 

JES3,  alternate  sybsystem  ID  for,  2-17 

JES3ID  parameter,  2-17 

job  accounting,  3-9 

capturing  data,  3-32 
user  exit,  11-6 


K 


Kodak  Optistar 
drivers,  10-16 

page-level  drivers,  10-7, 10-17 
report-level  drivers,  10-8, 10-16 


L 

LANGUAGE  parameter,  2-17 
language,  setting  default,  2-17 
LAST  (ERO  parameter),  6-5 
LGNRETRY  parameter,  2-18 
lines 

to  archive,  2-19 
to  print,  2-36 


LIST 

command,  4-10 
control  statement,  9^23 

LOAD 

control  statement,  9-25 
statement,  7-9,  A-6 

lock  file,  7-2,  7-7, 7-19,  A-3 

logical  views,  deleting,  9-15 

LOGO  parameter,  2-18 

logon  security,  3-23 

LRETPD  parameter,  6-6 

LSERVNAME  parameter,  3-5 

M 

maintenance  diagnostic  procedures,  B-1 

MARK  (ERO  parameter),  6-5 

master  authority,  setting,  2-18 

master  index,  A-2 
maintaining,  2-23 

MASTER  parameter,  2-18 

MAXIDLE  parameter,  3-5 

MAXLINES  parameter,  2-19 

MERGE 

control  statement,  10-23 
statement,  7-10 

messages 

descriptions,  12-1 
for  exceptional  conditions,  5-29 
for  tape  remounting,  2-33 
forward  recovery  data  sets,  8-5 
routing,  2-27 

microfiche 

producing  with  SARMFP,  3-15 
ruiming  batch  program  for,  3-17 
setting  output  order,  2-20 
specifying  start  procedure,  2-28 
user  exit,  11-16 

migration  to  ophcal  disk 

DSK2INTV  parameter,  10-13 
DSK2MIGD  parameter,  10-12 
DSK2TIME  parameter,  10-12 
options  for,  10-10 


lndex-6  CA- View  System  Reference;  Guide 


migratibn  to  optical  disk  (Continued) 
scheduling,  10-11, 10-13 
subtask,  10-14 

MINIDLE  parameter,  3-5 

MOUNT  parameter,  2-19, 3-6 

MSORTn  parameter,  2-20 


N 

NAME 

parameter,  2-21 
statement,  7-12 

NARGGLSL  parameter,  2-21, 5-6 
NBAGKUP  parameter,  2-21 
NBUF  parameter,  3-6 
NEWGLSL  parameter,  2-22 
NEWDEST  parameter,  2-22 
NEWFORM  parameter,  2-22 
NEWPASS  parameter,  2-23 
/  NGEND  parameter,  2-23 

NGENI  parameter,  2-23 
NGENT  parameter,  2-23 
NREAD  parameter,  3-6 
NREQ  parameter,  3-6 
NTHREADS  parameter,  3-6 


optical  disk 

configuring  the  interface,  10-5 
data  sets,  10-17, 10-19, 10-21 
database  maintenance  for,  10-22 
disk  objects,  10-20 
drivers,  overview,  10-1 
FileTek  driver,  10-18 
DSK2PARM,  10-8 
IBM  DASD  emulation  driver,  10-21 
Kodak  Optistar  driver,  10-16, 10-17 
DSK2PARM,  10-7, 10-8 
MOUNT  attribute,  10-8 
list  of  reports  on,  10-15 
migration,  5-30 

DSK2INTV,  10-13 
DSK2MIGS,  10-12 
DSK2TIME,  10-12 
options,  10-10 
subtask,  10-14 
OAM  driver,  10-19 
page-level  access,  10-3, 10-4 
page-level  drivers,  DSK2PARM,  10-6, 10-7 
reloading  SYSOUT  data  from,  10-23 
report-level  access,  10-3 
retention 

DSK2DAYS  parameter,  6-8 
DSK2NOTP  parameter,  6-8 
scheduling  migration  to,  10-11, 10-13 
storage  driver,  10-6 
unloading  SYSOUT  data,  10-23 

OUT  indicator,  2-24 


P 


OAM  drivers,  10-19 

OLOAD  statement,  7-12 

online  managementi  system  exit,  11-17 

online  retrieval  facility 
GA-ROscoe,  4-4 
GIGS,  4-5 
ISPF,4r-2 
overview,  4-1 
TSO;  4-2 
VTAM,4-5 


P  selection  code,  2-34 

granting  print  authority  for,  2-37 
maximum  lines  to  print,  2-36 

page  indexes 

creating,  9-22 
deleting,  9-15 

page-level 

acces  to  optical  disk,  10-3 
access  to  optical  disk,  10-4 
drivers,  10-7 
FileTekdrivers,  10-18 
FileT ex  drivers,  10-8 
IBM,  10-7 
IBMdrivers,  10-6 
Kodak  Optistar  drivers,  10-17 


OPEN  command,  4-10 

/ 

i  ) 


PAGEMARK  parameter,  2-24 
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passwords 

batch  protection  for,  3-24 
bypassing  verification,  3-28 
entering  new,  2-23 
for  retrieving  SYSOUT,  2-25 

PC 

downloading  to,  1-5 
transmission,  1-5 

PCOPIES  parameter,  2-41 

performance  problems,  Br-5 

PERM  control  statement,  9-27 

PMXTAPES  parameter,  2-41 

PMXYEARS  parameter,  2-41 

POPT  parameter,  2-41 

PRETAIN  parameter,  2-42,  6-9 

PRINT  control  statement,  9-29 

printing 

3800  printer 

attributes,  3-21 
SMF  t3^e-6  records,  3-13 
GA-Deliver  reports,  9-17 
external 

dynamic  program  call,  3-20 
interface,  3-17 
JES  data  set  interface,  3-18 
overview,  1-3 
setting 

destination,  2-22 
line  limit,  2-5 
SYSOUT 

at  time  of  archival,  5-7 
group,  9-29 

PRTALL  parameter,  2-24 
PRTASA  parameter,  2-24 
PRTCLSL  parameter,  2-24 
PTEXT  parameter,  6-11, 6-12, 6-13 
PTEXTn  parameter,  2-42 
PTHRESH  parameter,  2-43 
PWBATCH  parameter,  2-25 
PXCOND  parameter,  2-43 


Q 


QUIESCE  command,  4-7 


R 


RACE 

checking,  2-25 
protection,  3-25 

RCVPRIM  parameter,  2-25 

RCVSEC  parameter,  2-26 

RCVSPACE  parameter,  2-26 

RCVUNIT  parameter,  2-26 

record  length,  1-3, 5-2 

recovery,  8-3 
data  set 

defining,  3-23 

description  and  attributes,  A-6 
file,  7-25 

DATA  SET  NAME/ VGLSER  statement,  7-26 
FILESEQ  statement,  7-26 
file  utility,  7-26 
from  integrity  problems,  8-11 
from  media  problems,  8-9 
procedures,  8-7 
utilities,  8-6 

REDISP  parameter,  2-26 
RENAME  statement,  7-13 
REGRG  statement,  7-13 
report-level 

acces  to  optical  disk,  10-3 
Kodak  Optistar  drivers,  10-8, 10-16 

reprinting 

ASA  or  machine  control,  2-24 
default  value  for,  2-24 

RESTORE  statement,  7-15 

retention,  6-2.  See  also  ERG 
on  tape,  2-10, 2-26 

RETPD  parameter,  2-26 

ROUT  parameter,  2-27 

ROUTBKP  parameter,  2-27 
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SAMGLOSE  routine,  7-44 

SAMGETroutine,  7-44 

SAMINVL  routine,  7-46 

SAMMSG  routine,  7-47 

SAMOPEN  routine,  7-43 

SAMSCLS  routine,  7-50 

SAMSGET  routine,  7-49 

SAMSOPN  routine,  7-48 

SAR$xxxx  (device-specific  user  exit),  11-3 

SARAGFUX  (AGIF  archival  task  exit),  11-5 

SARAGT  accounting  program.  See  accounting  report 
program 

SARAGTUX  (job  accoimting  exit,  11-6 

SARAGTUX  user  exit.  See  accounting  data 

SARARAUX  (automatic  archival  user  exit),  11-7 

SARATHUX  (authorization  user  exit),  11-8 

SARBGH  (batch  processing),  9-1 
BPRINT  control  statement,  9-6 
GHANGE  control  statement,  9-7 
control  statements,  9-6 
DBASE  control  statement,  9-11 
DEFDIST  control  statement,  9-11 
DEFSYS  control  statement,  9-12 
DEFUSER  control  statement,  9-13 
DELETE  control  statement,  9-15 
SPRINT  control  statement,  9-17 
EXTRAGT  control  statement,  9-21 
GSS  interface,  9-2 
INDEX  control  statement,  9-22 
job  control  statements,  9-5 
LIST  control  statement,  9-23 
LOAD  control  statement,  9-25 
PERM  control  statement,  9-27 
PRINT  control  statement,  9-29 

SARBKTUX  (backup  cycle  user  exit),  11-11 

SARGOV  (recovery  file  utility),  7-25 

DATA  SET  NAME/VOLSERstatement,  7-26 
FILESEQ  statement,  7-26 

SARDOOUX  user  exit,  10-10 

SARD2LST  DD  statement,  10-15 


report,  10-15 

SARDBASE  (database  maintenance  utility),  7-2, 8-6 
ADDDS  statement,  7-5 
ADDLOGK  statement,  7-7 
control  statements,  7-4 
GOPY  statement,  7-8 
DELETE  statement,  7-9 
examples,  7-21 
IDXOUT  statement,  7-9 
LOAD  statement,  7-9 
MERGE  statement,  7-10 
NAME  statement,  7-12 
OLOAD  statement,  7-12 
RENAME  statement,  7-13 
REORG  statement,  7-13 
RESTORE  statement,  7-15 
SET  statement,  7-16 
STATUS  statement,  7-16 
UNLOAD  statement,  7-19 
UNLOGK  statement,  7-19 
VERIFY  statement,  7-20 
VERSION  statement,  7-20 

SARDBASE  RESTORE 

using  forward  recovery  data,  8-12 
without  forward  recovery  data,  8-13 

SARDSK2B  (optical  migration  subtask),  10-15 

SARDSTUX  (destination  user  exit),  11-12 

SARDVSUX  (DVS  Xerox  archival  task  user  exit), 
11-13 

SAREAS  (expanded  access  server),  3-4 

SAREASUX  (expanded  access  server  for  tape  and 
robotics  user  exit),  11-14 

SARIN  AGT  program,  3-14 

SARINIT  program,  10-14 

parameter  examples,  2-44 

parameters.  See  also  initialization  parameters 

SARJS2UX  (control  block  mapping  user  exit),  11-16 

SARMFP  (microfiche  processing),  3-15 

SARMFPUX  (microfiche  user  exit),  3-16, 11-16 

SAROMSUX  (online  management  system  exit),  11-17 

SARPAG  (tape  consolidation),  6-13 
canceling,  6-19 

Gopied  SYSOUT  Groups  Report,  6-17 
overview  of,  6-1 
reports,  6-15 
running,  6-18 
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SARPAG  (tape  consolidation)  (Continued) 

Tape  Status  List,  6-15 

SARPACUX  (archival  tape  consolidation  user  exit), 
11-18 

SARPATABDD  statement,  10-15 

SARPRFLTX  (user  profile  user  exit),  11-19 

SARPRTUX  (banner  page  user  exit),  11-20 

SARRCOV  (recovery  file  utility),  8-7 

SARRSP  (database  restore  utility),  7-27,  8-7 

SARSAM  (database  access  method),  7-41 
routines,  7-43 
SAMCLOSE  routine,  7-44 
SAMGET  routine,  7-44 
SAMINVL  routine,  7-46 
SAMMSG  routine,  7-47 
SAMOPEN  routine,  7-43 
SAMSCLS  routine,  7-50 
SAMSGET  routine,  7-49 
SAMSOPN  routine,  7-48 
SARSAM  routine,  7-51 

SARSEGUX  (security  user  exit),  3-24, 11-20 

SARSMFUX  (SMF  user  exit),  11-21 

SARSPFUX  (SYSOUT  selection  list  formatting  user 
exit),  11-22 

SARSRQUX  (selection  request  user  exit),  11-23 

SARSTC  started  task,  5-1, 5-27 

SARSTC22  archival  messages,  2-3 

SARSTCUX  (archival  task  user  exit),  11-24 

SARSUBUX  (submit  user  exit),  11-26 

SARTCHK  (tape  management  utility),  7-35 

SARTCP  (tape  copy  utihty),  7-30, 7-33 
NULL  statement,  7-33 
SKIP  statement,  7-34 

SARTDR  (restore  disk  utility),  7-36, 8-7 
control  statements,  7-37 
TADD  statement,  7-38 
TLOAD  statement,  7-39 

SARTPOUX  (tape  creation/volser  range  user  exit), 
11-26 

SARTSLST  (SYSOUTs  on  tape  utility),  7-40 

SARUSxUX  (user  ID  determination  user  exits),  3-23, 
11-28 


SARXGTUX  (exceptional  condition  checking  user 
exit),  11-30 

SARXMS  (cross-memory  task),  4-7 
changing  parameters,  4-11 

SARXTD  (system  extensions),  3-32 
parameters,  3-34 

secondary  storage.  See  optical  disk 

security,  3-23 
ACF2, 3-29 

controlling  logon,  3-23 

RACF,  3-25 

RACF  checking,  2-25 

user  exit,  11-20 

user  exit  SARSECUX,  3-24 

SELPNLS  parameter,  2-27 

SET  statement,  7-16 

SETPAGE  parameter,  2-27 

severity  ratings,  for  calling  technical  support,  B-10 

SMF  type-6  records,  2-28 
for  3800  printers,  3-13 
format,  3-11 
user  exit,  11-21 

SMP  parameter,  2-28 

SRBKLST  report,  5-3 

STAGKBU  parameter,  2-28 

START  parameter,  2-28 

StarTCC,  B-6 

starting 

ACIF  archival,  5-9 

cross-memory  task,  4r-7 

DVS  archiver,  5-14 

the  archival  task,  5-27 

the  optical  migration  subtask,  10-14 

STARTSLST  utility,  8-7 

STATUS  statement,  7-16 

stopping 

ACIF  archival,  5-9 

cross-memory  task,  4-7 

DVS  archiver,  5-14 

the  archival  task,  5-28 

the  optical  migration  subtask,  10-14 

storage  groups 

consolidating,  6-19 
defining,  2-43 
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storage  groups  (Continued) 

defining  extensions  for,  2— 44 
setting  attributes  for,  2-30 
setting  default  for  tape,  2-29 
specifying,  6-7 

STORGRPO  parameter,  2-29 

STORGRPx  parameter,  2-43, 6-7 

STORGRXO  parameter,  2-30 

STORGRXn  parameter,  2-44 

Support  Contact  Information  Form,  B-15 

SUSPEND  command,  4-9 

swappable  GA-View  task,  2-4 

SYSOUT  groups 
definition  of,  1-3 
deleting,  2-8 
listing,  9-23 

loading  from  tape  to  disk,  9-25 
setting  status,  9-27 

SYSOUT  ID 

assigning  with  ERO,  6-11 
example  of,  1—4 
overview  of,  1-3 

system  extensions,  3-32 
activating,  3-32 
deactivating,  3-34 
parameters,  3-34 


T 


TADD  statement,  7-38 
tape 

archival  data  sets,  A-4 
copy  utility,  7-30, 7-33 
NULL  statement,  7-33 
SKIP  statement,  7-34 
duplex,  7-30,  7-31 
duplex  data  set,  A-5 
listing  SYSOUTS  on,  7-40 
management  utility,  7-35 
map  reports,  7-31 

tape  consolidation 

SARPAC,  2-41, 2-43, 6-13 
SARPACUX,  11-18 

tape  creation/volser  range  exit — SARTPGUX,  11-26 


tape  processing,  setting  options  for,  2-31 

tape  retention,  6-7 

COPIES  parameter,  6-7 
GENS  parameter,  6-7 
parameters,  6-6  to  6-10 
RETPD  parameter,  6-7 
STORGRPx  parameter,  6-7 
VIEWTAPE  parameter,  6-8 

tape  storage  groups 
consolidating,  6-19 
defining,  2-43 

defining  extensions  for,  2-44 
setting  attributes  for,  2-30 
setting  default,  2-29 
specifying,  6-7 

TAPEGLSL  parameter,  2-32 

TAPEOPT  parameter,  2-31 

TAPESEQ  parameter,  2-32 

TBAGKUP  parameter,  2-33 

technical  support 
calling,  B-6 
online,  B-6 
phone  numbers,  B-9 

TIME  parameter,  2-33 

TLOAD  statement,  7-39 

TP054  parameter,  2-33 

troubleshooting,  B-3 

TSO;  A-9 

and  ACF2, 3-30 

and  RACF,  3-27 

cross-memory  services,  4-2 

forms  name  for  online  retrieval,  2-34 

online  retrieval  facility,  4-2 

scheduling  background  retrieval,  2-35 

SYSOUT  destination  for  online  retrieval,  2-34 

TSOCLS  parameter,  2-34 

TSODEST  parameter,  2-34 

TSOFORM  parameter,  2-34 

TSOSCHED  parameter,  2-35 

TYPE  parameter,  3-7 
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u 


V 


'v^ 


UNITSPEC  parameter,  2-35 
UNLOAD 

control  statement,  10-23 
parameter,  2-35 
statement,  7-19,  A-6 

UNLOCK  statement,  7-19 

user  exits 

ACIF  archival  task,  11-5 
authorization,  11-8 
automatic  report  archival,  11-7 
backup  cycle,  1 1-1 1 
banner  page,  11-20 

GICS/ cross-memory  connection  ID,  11-2 
control  block  mapping,  11-16 
cross-memory  connection  ID,  11-2 
destination,  11-12 
device  specific,  11-3 
DVS  Xerox  archival  task,  11-13 
exceptional  condition  checking,  11-30 
expanded  access  server  for  tape  and  robotics, 
11-14 

job  accounting,  11-6 
microfiche,  11-16 
online  management  system,  11-17 
overview,  ll-l 

permanent  archival  consolidation,  11-18 
security,  11-20 

selection  code  requests,  11-23 
selection  list  formatting,  11-22 
SMF  type-6, 11-21 
submit,  11-26 

user  ID  determination,  11-28 
user  profile,  11-19 

user  IDs 

adding  and  modifying,  9-13 
deleting,  9-15 
listing,  9-23 
user  exits,  11-28 

user  level,  setting,  2-36 

user  mode,  setting  default,  2-7 

user  profile user  exit,  11-19 

USERIDs,  listing,  9-24 

USERLVL  parameter,  2-36 

utilities.  See  database  utilities  and  listings  of 
individual  utilities 


VERIFY  statement,  7-20 

VERSION  statement,  7-20 

VIEWTAPE  parameter,  6-8 

VM/GMS,  and  ACF2, 3-30 

VPRTAPPL  parameter,  2-36 

VPRTMAXO  parameter,  2-36 

VPRTONL  parameter,  2-37 

VPRTRINT  parameter,  2-37 

VPRTRTRY  parameter,  2-37 

VTAM,A-9 

and  AGF2, 3-30 
and  RAGF,  3-27 

multiple  cross-memory  regions,  4-11 
online  retrieval  facility,  4-5 
setting  up  Print  Option,  2-36 

w 

WAIT  parameter,  2-38 

X 

XGOND  parameter,  6-9 

Xerox  reports 

archiving,  5-14 
indexing,  5-15 

XPDS  reports.  See  Xerox  reports 
XPRINT  parameter,  2-38 
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